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PREFACE 


APPLIED MICROSYSTEMS CORPORATION is proud of its role in the 
systems development industry and conscious of its important contribution. 
However, it assumes no liability for errors or for any damages from use of 
this manual or the equipment it accompanies. 

We have made every effort to document this product accurately and 
completely. We reserve the right to make changes to this manual without 
notice. 

The ESI800 Emulator is intended for use in developing, debugging, and 
testing Motorola 68000/68008/68010/68020 microprocessor-based sys¬ 
tems. This manual assumes that the user is familiar with the terminology 
and capabilities of the Motorola series microprocessor. 


i 



ES 1800 Emulator Reference Manual for 68000 Series Microprocessors 


Unpacking and Inspection 

Your Emulator has been inspected and tested for electrical and mechanical 
defects before shipping, then configured for the line voltage requested. 
Although the Emulator was carefully packed, check it for possible transit 
damage and verify that the following units are present. If you find any 
damage, file a claim with the carrier and notify Applied Microsystems 
Corporation (Customer Service 1-800-426-3925). 

STANDARD EQUIPMENT 

■ Emulator chassis with power cord 

■ Main control boards and pod assembly 

uES1800 Emulator Reference Manual for 68000 Series 
Microprocessors 

OPTIONAL EQUIPMENT 

■ Control Boards 

■ overlay memory 

■ symbolic debug 

■ Logic state analysis pod assembly 

■ Carrying case 


ii 
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Warning 

This equipment generates, uses, and can radiate radio frequency energy 
and, if not installed and used in accordance with the instruction manual, 
may cause interference to radio communications. It is temporarily per¬ 
mitted by regulation and has not been tested for compliance with the limits 
of Class A computing devices pursuant to Subpart J of Part 156 of FCC 
Rules, which are designed to provide reasonable protection against such 
interference. Operation of this equipment in a residential area is likely to 
cause interference. It is up to the user, at his own expense, to take 
whatever measures may be required to correct the interference. 
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Service 

If the ES1800 unit needs to be returned for repairs, Applied Microsystems 
Customer Service will issue a return authorization number. To obtain the 
necessary return authorization number and shipping information, call 
1-800-426-3925, and ask for Customer Service. After the expiration of 
the warranty period, service and repairs are billed at standard hourly rates, 
plus shipping to and from your premises. 


IV 
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Limited Hardware Warranty 

Applied Microsystems Corporation warrants that all Applied Microsystems 
manufactured products are free from defects in materials and workman¬ 
ship from date of shipment for a period of one (1) year, with the exception 
of mechanical parts (such as probe tips, cables, pin adapters, test clips, 
leadless chip sockets, and pin grid array adapters), which are warranted for 
a period of 90 days. If any such product proves defective during the 
warranty period. Applied Microsystems Corporation, at its option, will 
either repair or replace the defective product. This warranty applies to the 
original owner only and is not transferable. 

To obtain warranty service, the customer must notify Applied Microsys¬ 
tems Corporation of any defect prior to the warranty expiration and make 
arrangements for repair and prepaid shipment to Applied Microsystems 
Corporation. Applied Microsystems Corporation will prepay the return 
shipping to US locations. For international shipments, the customer is 
responsible for all shipping charges, duties, and taxes. Prior to returning 
any unit to Applied Microsystems Corporation for warranty repair, a 
return authorization number must be obtained from Applied Microsystems 
Corporation’s Customer Service Department (see Service section on the 
previous page). 

This warranty shall not apply to any defect, failure, or damage caused by 
improper use, improper maintenance, unauthorized repair, modification, 
or integration of the product. 
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Hardware Extended Warranty 

Applied Microsystems Corporation’s optional EXTENDED WARRANTY 
is available for all hardware products for an additional charge at the time 
of the original purchase. The EXTENDED WARRANTY may be pur¬ 
chased to extend the warranty period on mechanical parts normally 
restricted to 90 days to a total of one (1) or two (2) years and to extend the 
warranty on electrical parts and all other mechanical parts to two (2) years. 


Hardware Service Agreements 

SERVICE AGREEMENTS are available for purchase at any time for 
qualified Applied Microsystems Corporation manufactured products. The 
SERVICE AGREEMENT covers the repair of electrical and mechanical 
parts for defects in materials and workmanship. For information, contact 
your local sales office. 


vi 
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Section 1 


INTRODUCTION 


The ESI 800 Emulation system allows you to analyze and control a target 
environment, consisting of hardware or software, in real time. To use the 
ESI800 with your target hardware, simply remove the target system’s 
microprocessor and plug in the ESI800 Emulator. Your system uses the 
Emulator in place of the microprocessor and behaves as if the target 
microprocessor is present. The Emulator continues to run until you 
manually stop it or it encounters a user defined stop condition. This 
predefined condition can be in the form of single-step operation 
statements or more complex event monitoring (WHEN/THEN) statements. 

During the debugging or integration process you can read and write to the 
microprocessor registers or memory locations and execute programs 
contained in the target system memory. The ESI800 Emulator also allows 
you to debug software without being physically connected to the target 
system. In this configuration, the Emulator uses a null target combined 
with overlay memory capabilities. 

Information in this manual applies to Motorola 68000/68008/68010/68020 
microprocessors only. For more complete information on your particular 
chip, refer to the reference manuals: 16 Bit Microprocessors Users Manual 
(for the 68000/08/10 microprocessors) or the MC68020 32 Bit 
Microprocessors Users Manual (for the 68020 microprocessor) published 
by Motorola Corporation. 
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How to Use This Manual 

This manual is your guide to using the Applied Microsystems Corpora¬ 
tion’s ES1800 Emulator for Motorola 68000/08/10/20 microprocessors. 
For your first time using the ESI800, read through the Introduction and 
Getting Started sections and refer to the Hardware section to make sure 
your hardware is set up correctly. 

Once you are familiar with the Emulator, the sections on the ES language, 
system commands and target commands provide information on all of the 
available commands. The comprehensive Index and Appendix A: ES 
Language Mnemonics are useful for finding specific information in the 
manual. 

The manual is organized as follows: 

Section 1: Introduction introduces Applied Microsystems Corporation’s 
ESI800 Emulator for the 68000/08/10/20 microprocessors. It explains 
emulation, set-up, and configuration requirements, and provides an 
overview of the features of the ESI800. 

Section 2: Getting Started provides a checklist for setting up your Emula¬ 
tor and target system, starting and testing the Emulator, and storing cus¬ 
tomized system variables in EEPROM. 

Section 3: Hardware contains all the information on the Emulator, the 
control boards, the rear panel, the pod, and the serial ports, as well as in¬ 
formation on maintenance and troubleshooting. 

Section 4: ES Language explains the structure of the language that con¬ 
trols the Emulator, with clear explanations of the help menus, prompts, 
special modes and characters, and language-related error messages. 

Section 5: System Commands provides a reference to commands that con¬ 
trol the Emulator system. It is divided into sections on setup, serial com¬ 
munications, download operations, registers, trace memory, macros, and 
symbols. 

Section 6: Target Commands is a reference to commands that directly 
control the target system. It is divided into sections on running the target 
program, memory commands, the line assembler, the memory disassemb¬ 
ler, memory mode, and diagnostics. 
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Section 7: 68000/08/10 Event Monitor System explains the powerful 
breakpoint and control system, including the structure of the system, 
breaking emulation, counting events, using special interrupts, and tracing 
events. (This chapter pertains to the 68000, 68008, and 68010 
microprocessors.) 

Section 8: 68020 Event Monitor System explains the powerful breakpoint 
and control system, including the structure of the system, breaking 
emulation, counting events, using special interrupts, and tracing events. 
The different trace modes that pertain only to the 68020 microprocessor 
are covered, as well as setup shortcuts. 

The Appendices are a quick reference to ES Language mnemonics, 
explanations of the hardware error messages and serial data formats. 
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System Setup 

The ESI800 can debug and integrate software and hardware. Setups for 
each system may be different. In every combination, there is a target 
system, which can be hardware, software alone (if you are using the 
Emulator’s overlay memory to debug software), or a combination of the 
two. The target system is the environment you intend to emulate. 

The ESI800 Emulator consists of a chassis assembly which houses the 
control boards and an emulator pod which houses the emulating micropro¬ 
cessor. The Emulator can be controlled with a dumb terminal, which can 
be your development system CRT or another device set to function in 
dumb terminal mode. You can enhance this basic system by adding the 
optional Logic State Analyzer (LSA) pod. This provides 16 additional 
input lines giving access to signals other than the normal address, data, and 
control signals of the microprocessor. You may also add an optional 
overlay memory board. Overlay memory can be mapped anywhere in the 
address space of the target system. The overlay memory board provides 
additional capabilities including the ability to debug software with or 
without a target system. 

The stand alone environment (refer to diagram on page 1 -6) consists of the 
Emulator and a dumb terminal or equivalent connected to the terminal 
port. This setup can debug target systems with software already installed, 
or short hand-entered routines. The stand alone configuration is common 
in manufacturing test and service facilities. 

The Emulator can also use data stored in a host development system by 
setting up a hosted environment (refer to diagram on page 1-6). The 
Emulator is still under the direct control of the CRT but can load data 
from the host system’s data files. 

By attaching a printer, data and code from your target system can be 
printed out in machine or assembly language. You can also print all Emu¬ 
lator commands and their results. The Emulator system has two serial 
ports and uses standard RS232C serial port protocol. Each port can be in¬ 
dependently configured for baud rate, data length, and number of stop 
bits. 
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Software for driving the Emulator is available from Applied Microsystems 
Corporation for the IBM PC and compatibles, SUN, APOLLO and VAX. 

The Emulator can also be totally controlled by your host system. This 
hosted software environment (refer to diagram on page 1-6) requires 
special host resident software. Drivers and High Level Debuggers are 
available from Applied Microsystems for most languages and host systems. 
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Figure 1. Environments 
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System Operation 

OVERVIEW 

The ESI800 has two basic operational modes: run mode and pause mode. 
Pause mode is used to set up the system configuration and to display 
information after leaving emulation. System setup is accomplished from 
two menus. The first menu contains all external communication variables; 
the second contains the control switches for emulation and serial port data 
output. Both setups can be saved to EEPROM and automatically loaded at 
power-up. 

Run mode or emulation means that the microprocessor in the Emulator pod 
is running a program in the target system, allowing you to see what is 
happening within the target system. Emulation stops when (1) you stop it, 
(2) user-defined breakpoints are enabled and occur, (3) you reset the 
system, or (4) errors occur in the target system. 

When you manually stop emulation or a breakpoint is reached, you enter 
pause mode. All registers and addresses are then available for examina¬ 
tion, along with a trace history of performance of the microprocessor. A 
command language allows you to enter emulation in the desired state and 
leave emulation when a specific combination of events is detected in the 
target. 

ES LANGUAGE 

The ESI800 uses its own command language. To take advantage of the 
sophisticated operations of the Emulator, you must understand the general 
concepts of this language. The Emulator operates in response to command 
statements composed of command menmonics and, for some commands, 
arguments. An argument to a command is an additional value entered as 
part of the command sequence, such as an address range or base value. Ar¬ 
guments can consist of single values, expressions, or lists. 

The command statements form a control language, similar to higher-level 
computer languages. Like a computer language, the operators and values 
can be combined to form complex expressions. Statements have a 
maximum length of 76 characters and can be extended by the use of 
macros. 
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The ES Language contains registers, counters, and conditional statements 
allowing the user full control over the operation of the target system. To 
complete the language, a full set of error messages is provided for (1) tar¬ 
get hardware, (2) Emulator hardware, (3) target software, and (4) ES Com¬ 
mand Language syntax. 

REAL TIME 

Since the pod processor is identical to your target microprocessor, the tar¬ 
get system runs in real time. No wait states are inserted by the Emulator 
during run mode. Additionally, the Emulator’s internal clock provides a 
completely self-contained microprocessing environment that allows you to 
execute your software without connecting the Emulator to your target 
system, using the null target. 

TRACE MEMORY 

Trace memory functions as a history of your target system program’s exe¬ 
cution. This memory can record 2046 bus cycles and display these in ma¬ 
chine or assembly language. All address lines, data lines, processor status 
lines, and 16 bits of external logic input are traced. If something unex¬ 
pected happens during program execution, trace memory can be reviewed 
to determine the sequence of commands executed prior to the unexpected 
event. When used in conjunction with the trace disassembler, hardware 
and software problems can be quickly tracked down. 

Trace memory can be programmed to selectively trace events only when 
certain conditions are met. Program execution can be stopped at any point, 
either manually or using the Event Monitor System. The address, data, and 
control signals of the most recently traced cycles can then be critically 
reviewed. 
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OVERLAY MEMORY 

Overlay memory is Emulator working memory, which can be used in a 
variety of ways. When debugging software without target hardware, the 
target program is loaded into overlay memory where it can be edited and 
positioned in the target system address space as desired. The program 
executes in real time as if it resided totally in the target system. Overlay 
memory is also useful when target hardware is connected, for loading 
portions of software, making patches, and checking programs not yet 
committed to PROM. 

The overlay memory is RAM with appropriate address and control logic, 
ranging in size from 32K to 2M bytes and locatable in 2K-byte segments 
throughout the system. Each segment can be assigned one of four attri¬ 
butes: target, read/write, read-only, or illegal. Unmapped memory is 
assigned the target attribute by default. Overlay memory mapped as read¬ 
only can always be modified by the Emulator. However, if a target 
program tries to write to read-only overlay, emulation stops and an error 
message is displayed. 

When a segment of memory is mapped, program accesses to that memory 
range are directed to the overlay instead of the target. Overlay memory 
accesses occur in real time, with no wait states added by the Emulator. 

EVENT MONITOR SYSTEM 

The ESI 800’s Event Monitor System provides unprecedented breakpoint 
and system control, enabling the user to isolate and break on any 
predefined series of events and then perform actions defined by 
WHEN/THEN conditional statements. The user controls and monitors the 
target with the Event Monitor System by defining statements that specify 
single or multiple events through logical combinations of address, data, 
status, pass counter, and optional logic field states. When those events are 
encountered in the target system program, the ESI800 can break emula¬ 
tion, trace specific sequences, count events, and trigger outputs, all inde¬ 
pendently, allowing the user to analyze the cause-effect relationship es¬ 
tablished by the event/action sequences defined. 

The Event Monitor System uses four groups, each containing eight 
registers, to let the user monitor a complex series of events through 
multiple actions and combinations of comparator registers. The system 
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uses one group at a time, with each WHEN/THEN statement active in a 
specific group. WHEN/THEN statements can switch to different groups 
and access conditional statements and registers for that group. The user 
can control the tracing of 2046 machine cycles, selecting the desired 
instructions to be recorded in the trace memory. 

OPTIONAL SYMBOLIC DEBUGGER 

The symbolic debug option allows you to assign frequently used values to 
symbol names that are easily remembered. Features include: 

■ Reference to an address by a name instead of a value 

■ Display of all symbols and sections with their values 

■ Editing (entry and deletion) of symbols and their values 

■ Automatic display of symbolic addresses during disas¬ 
sembly 

■ Section (module) symbols that can be used as range argu¬ 
ments and for section offsets in trace disassembly 

■ Upload and download of symbol and section definitions 
using standard serial formats 

Because symbols are a powerful extension of the Emulator, they are fre¬ 
quently used in examples throughout Section 5, System Commands. Please 
note that if you have not yet purchased the symbolic debug option, you 
may need to modify these examples. 

OPTIONAL LOGIC STATE ANALYZER (LSA) 

LSA inputs can qualify event specifications in the Event Monitor System. 
In the simplest form, specific bit patterns at the LSA inputs can cause a 
breakpoint. The LSA comparator can detect complex event specifications 
as well. The LSA provides an additional means of monitoring information 
from other parts of the target system, beyond the normal recording of trace 
data performed by the Emulator. This is useful when monitoring (1) 
buffers suspected of failure, (2) decode logic, (3) memory management 
circuit translations, and (4) asynchronous external events. 
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DIAGNOSTIC FUNCTIONS 

Diagnostics available in the ESI 800 Emulator include both RAM/ROM 
tests and scope loops. RAM test routines verify that RAM is operating 
properly. They can be run on the target RAM or Emulator overlay 
memory and may be executed in either byte or word mode. ROM tests 
include a built-in CRC algorithm. 

High speed memory scope loops for troubleshooting with an oscilloscope 
are built into the Emulator firmware. They can be used for locating stuck 
address data, status or control lines, and generating signatures using 
signature analysis equipment. 

The firmware that generates the scope loops is optimized for maximum 
speed of execution. This short cycle time allows the hardware engineer to 
review the timing of pertinent signals in the target system without using a 
storage oscilloscope. The scope loops can be executed in either byte, word, 
or long word mode. 
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Section 2 


GETTING STARTED 


Introduction 

This section provides a checklist for setting up your Emulator and target 
system, starting and testing the Emulator, and storing customized system 
variables in EEPROM. 


Emulator Set-up 

1. Refer to page 3-1 and verify that proper grounding and 
power requirements have been met. 

2. Remove the front cover of the Emulator by turning the 
thumbscrews counterclockwise. The pod and LSA pod 
may need to be unplugged in order to do this. 

3. Verify that the main control board and the memory 
control board are in the top two slots of the Emulator 
chassis. 

4. Verify that the trace/break board is in the third bus slot 
of the Emulator chassis. 

5. If you are using overlay memory, verify that the overlay 
memory master, and/or master and slave boards, if 
needed, are inserted. 
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6. Verify that the correct Emulator board for your target 
microprocessor is in the bottom slot. (See page 3-4 for 
board positions.) 

7. Verify that all boards are firmly seated in their mother¬ 
board connectors. 

8. Set the thumbwheel switch on the main control board for 
your particular system variables (see page 3-5). 

System default variables in switch position 0 are: 


- 9600 baud 

- 8-bit word length 

- One stop bit 

- No parity 

- Full duplex 

- No echo 

- Terminal control 

- XON and XOFF are recognized 

- 8th data bit 

set to 0 or a space 


9. Verify that the three-position toggle switch on the 
memory control board is in the center position. (See page 
3-4). 

NOTE: If you are using an early ESI800 model, the above 
comment may not apply. Follow the instructions pro¬ 
vided at the time of purchase. 

10. Replace front panel and attach the correct pod assembly 
(see page 3-8). A pod assembly must be connected to the 
Emulator even if you are not using target hardware. 

11. OPTIONAL: Connect Logic State Analyzer pod (see page 
3-11). 

12. Verify that the RS232C cable connections are correct for 
the system configuration you plan to use (see page 3-12, 
Pin Configurations). 

13. Verify that the RS232C baud rates and data requirements 
are set the same on both the Emulator and the terminal 
(see pages 3-5). 


2-2 





Section 2: Getting Started 


NOTE: the 68020 microprocessor requires different pod 
connections depending on the trace memory mode you 
are intending to use (refer to page 3-8) 
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Target System Set-up 

1. Check that the target has a 48 pin package dual in-line 
socket for the 68008 chip, a 64 pin package for the 
68000/68010 chips, and a 114 pin grid array for the 68020 
chip. 

2. Check that a good ground exists at the microprocessor 
socket using an ohmmeter. 

3. Validate the power supply at the microprocessor socket. 
It should read 5V ±10%. 

4. Check for a valid clock signal at the target microprocessor 
socket. 

5. Turn off target system power and Emulator power. 

6. Plug in the probe tip (see page 3-8). 
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Power-On Sequence 

TARGET SYSTEM PRESENT 

1. Turn on the target system. 

2. Turn on the Emulator. 

3. Reset the target system (see page 6-14). 

NO TARGET SYSTEM 

1. Verify that the pod is connected to the Emulator (see 
page 3-8). 

2. Remove the conductive rubber probe tip protection and 
install Null Target Software Simulation Tool (see page 
3-10). 

3. Power-up the Emulator. 

4. The log-in banner is displayed (see page 4-25). 

When you power-up the Emulator, all registers, maps, event clauses, and 
system variables are either cleared or set to default values. Examine the 
SET and ON menus (see pages 5-3 and 5-9) and configure the system as 
desired. Your special setup can then be stored in EEPROM (see page 
5-25). By setting the rotary switch on the controller board to the proper 
position, your special setup can be autoloaded on power-up. 

The ESI800 Emulator system is now running and ready to accept ES Lan¬ 
guage commands. 
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Test Run of System 

Use this test guide after the system configuration is correct and the ES 
prompt is displayed ([>]). 

A system test run consists of the following 9 steps: 

1. Initialize Emulator 

2. Map overlay memory 

3. Test RAM 

4. Enter a program 

5. Verify a program 

6. Run the Emulator 

7. Stop the program 

8. Display the trace buffer 

9. Set a breakpoint 

This test requires that an optional overlay memory board is installed. This 
demonstration does not need a target system. 

If you encounter difficulty with the ESI800 hardware, call the Applied 
Microsystems Corporation Customer Service hot line at 1-800-426-3925 
for assistance. 

1. INITIALIZE THE EMULATOR 

Enter the following to initialize the Emulator: 


>SET 1,0;SAV;SET 1,1;SAV;SET 1,0 
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2 . MAP RAM MEMORY 

Map all of the overlay memory available to the Emulator. 


>MAP 0 TO XXXX 


(Where XXXX is the ending address (in hex) of the amount of overlay 
memory installed.) The following table provides a quick reference for hex 
values corresponding to overlay memory sizes. 


Hex value 

Overlay memory 

7FFF 

32K 

OFFFF 

64K 

1FFFF 

128K 

3FFFF 

256K 

7FFFF 

512K 


For example, to map 64K, enter: 


>MAP 0 to OFFFF 


For more information, refer to page 5-55. 


3. TEST RAM 

Test all overlay memory installed by entering: 


>SF 1,0 TO XXXX 


(Where XXXX is the ending address (in hex) of the amount of overlay 
memory installed.) If there is a failure, repeat mapping and testing. 

If RAM test continues to fail, reseat all PAL and RAM chips on the 
overlay memory. 

For more information, refer to Diagnostic Functions, page 6-49. 
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4. ENTER PROGRAM 

Enter a short program by invoking the line assembler and entering 68000 
op codes (see page 6-34). 


>ASM 400 

**** 680XX LINE ASSEMBLER **** 
000400>NOP 
000402>/ 

000404>/ 

000406>/ 

000408>/ 

00040A>BRA $400 
000400X 


NOP is a null operation. Each time you type the slash ( @ ), you repeat the 
previous command. You have entered the equivalent of five lines of 
NOPs. The 0 at the end exits the assembler. 


5. VERIFY THE PROGRAM 

Single step through the program, to verify that it works, by entering: 



The disassembled trace should show that NOPs were executed and that the 
branch was taken correctly. 

For more information on the STP command, refer to page 6-8. 
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6. RUN THE EMULATOR 
Enter RUN. 


>RUN 

R> 


The [r>] prompt should be displayed with no error messages. This indicates 
the Emulator is running in real time, executing the program. 

7. STOP THE PROGRAM 
Enter STP to stop. 


R>STP 

The Emulator should stop running and display the PC register value. 

8. DISPLAY THE TRACE BUFFER 

Enter DRT to display the execution history of the program. 

>DRT 


The display should show sequence numbers between 0 and 20, and address 
values between 400 and 40E. Then enter DTB. 


>DTB 


The display should show a disassembled trace of the program with NOPs 
and BRA $000400. 
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9. SET A BREAKPOINT 

Set a breakpoint to verify that the Event Monitor 
execution when a defined condition is met. In this case, 
cutes 100 (hex) bus cycles, then breaks. 

Enter: 

System will halt 
the Emulator exe- 

>WHEN DC1 THEN CNT 


>WHEN CL THEN BRK 


>DC1=0XXXX 


>CL=100 


>RBK 


R> 



This causes the counter to be incremented each time data comparator 1 sees 
a data bus value between 00000 and 0FFFF. When the count limit of 100 is 
reached, emulation will break. 

If a break does not occur: 

1. Enter STP. 

2. Set PC to 400. 

3. Enter DES 1 and verify that you have entered the 
WHEN/THEN statement and comparator values as shown 
above. 

4. Type RBK again. 

If no break occurs, call Applied Microsystems Customer Service at 
1-800-426-3925 for assistance. 
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HARDWARE 


Emulator Chassis Assembly 

The Emulator chassis is the metal enclosure housing the control boards for 
your target system. This rack mountable chassis houses up to six boards as 
shown in the Figure on page 3-4. 

The Emulator power supply is also in this chassis. A power switch on the 
rear panel is the only external panel control. 

WARNING! 

A cooling fan and vent for the Emulator are located on the left 
side panel of the chassis. The warm air exhaust vent is in the 
RIGHT side panel. Blocking either of these panels may cause the 
Emulator to overheat. 

SYSTEM GROUNDS 

The ESI800 Emulator has three grounding systems: 

1. A CHASSIS ground from the metallic enclosure of the 
unit to the power filter. 

2. An AC PROTECTIVE ground from the green ground 
wire of the AC power cord and the chassis ground at the 
power filter. 
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3. A SIGNAL ground connected by a jumper at the power 
supply terminal strip to the chassis ground. The Emulator 
has a three-wire power cord with a three-terminal 
polarized plug. The ground terminal of the plug is 
connected internally to the metal chassis parts of the 
Emulator. 


WARNING! 

Failure to ground the system properly may create 
a shock hazard. 
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Emulator Control Boards 

Removing the front panel of the Emulator chassis exposes the chassis card 
cage as shown on page 3-4. This panel is opened by turning two knobs, 
located in the upper corners of the front panel, counterclockwise. 


Main Control Board 


Memory Control Board 


Trace/Break Board 


Overlay Memory 
Board( s ) 


Emulation Board 


The main control board holds the 
controlling 6809 CPU for the Emulator, the 
EEPROM, two serial ports, and RAM. The 
16-position thumbwheel switch located on 
this board determines the system variables 
and serial line baud rates for autoloading on 
power-up. Refer to page 3-5, for each 
switch position setup. Switch position 0 
autoloads default system variables. 

The memory control board holds the 
memory management logic and optional 
symbolic debug memory. The three- 
position toggle switch located below the 
main control board thumbwheel switch 
must be in the center position. If the toggle 
switch is in either of the other two positions 
the Emulator will not work properly. 

The trace/break board holds trace memory, 
the Event Monitor System, and the logic 
state analyzer (LSA) interface. 

The overlay memory board set is optional 
and can hold 32K, 64K, 128K, 256K or 
512K of memory. 512K of memory 
requires a slave board. 

There are six different emulation boards 
depending on the target microprocessor you 
are using. 
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Figure 2. Control Boards 
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Emulation Board 

Thumbwheel Switch Settings 

POSITION 

PARAMETERS 

BAUD RATE 

0 

Factory Default* 

9,600 

1 

User "O" defined 

User defined 

2 

User "I" defined 

Terminal control 

User defined 

3 

User "O" defined 

Terminal control 

User defined 

4 

User "I" defined 

Computer control 

User defined 

5 

Factory Default* 

Computer control 

110 

6 

Factory Default* 

300 

7 

Factory Default* 

1,200 

8 

Factory Default* 

2,400 

9 

Factory Default* 

4,800 

A 

Factory Default* 

7,200 

B 

Factory Default* 

19,200 

C,D,E 

, F Reserved for factory 

use 

*Factory Default Parameters 


- 8-bit word length 

- one stop bit 


- no parity 

- full duplex 


- Terminal control 

- XON and XOFF are 

recognized 

no echo 

- baud rate the same for both terminals 


- 8th data bit set 

to 0 or a space 
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Emulator Chassis Rear Panel 

The rear panel of the Emulator mainframe is shown in Figure 3 on page 
3-7. 


Serial Ports The two serial ports are RS 232C ports 

labeled IterminalI and IcomputerI , Pins are 
discussed on page 3-12. 

System configuration determines which 
port your peripheral equipment connects to 
(see page 1-4). 

Trigger Output The ES1800 Emulator provides a TTL 

trigger strobe output controlled by the 
Event Monitor System. The trigger output 
is available at a BNC connector on the rear 
panel of the chassis and on a clip lead 
attached to the optional Logic State 
Analyzer (LSA) pod. Refer to Section 7 
(68000/08/10) or Section 8 (68020) for 
information on Event Monitor System 
actions. 

The trigger can be used for such things as: 

■ Synchronizing an oscillo¬ 
scope to the execution of an 
I/O routine. 

■ Measuring the duration of a 
routine by asserting the 
trigger for its duration and 
using a timer-counter. 

■ Cross-coupling two or more 
Emulators so that an event 
in one can control events in 
the others. 
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Power Switch Before powering up, two items should be 

checked: 

1. Proper grounding of power cable 
(see page 3-1). 

2. Proper power-up sequence of 
Emulator, target system, and/or 
peripheral equipment. (See Power- 
On Sequence, page 2-5.) 

Line Fuse A 3 amp slow-blow fuse for 110V operation 

or a 1.5 amp slow-blow fuse for 220V 
operations. Remove the fuse by turning the 
fuse holder counterclockwise. 

Figure 3. Rear Panel 


TERMINAL 

PORT 


COMPUTER 

PORT 


TRIGGER 

OUTPUT 


POWER 

SWITCH 
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Pod Assembly 

The pod assembly is the communications link between the ESI 800 
Emulator and your target system. A 40 inch ribbon cable connects the pod 
assembly to the Emulator board. An 11 inch ribbon cable ends in a probe 
tip that is normally inserted into the microprocessor socket in your target 
system. 

The proper pod assembly is determined by the microprocessor being 
emulated. 

68020: 

The 68020 microprocessor has four trace memory modes. Each mode 
requires a different Emulator/pod assembly configuration. 

The 68020 pod has three ribbon cables that connect to the emulator chassis. 
All three cables are located on the same side of the 68020 pod. The bottom 
two ribbon cables for all four trace modes, always connect to the Emulator 
chassis’ emulation board. For modes 1, 2, and 3 the top ribbon cable 
connects to the Emulator chassis trace and break board. For mode 0 this 
top cable is not used and in its place the LSA pod assembly is connected to 
the trace and break board. The lower six LSA bits are available in mode 3 
if you choose to use them. To do so, the LSA pod assembly connects to the 
front panel of the 68020 pod. 

Refer to page 8-14 for more information on 68020 trace modes. 
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Null Target Software Simulation Tool 

The Null Target Software Simulation Tool is a device that is about the size 
and shape of a microprocessor chip. It is to be plugged onto the end of 
your pod assembly probe tip adapter. This device allows you to run the 
ESI800 Emulator without having to be connected to a target system. 
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Logic State Analyzer (LSA) Assembly 

An optional feature, the Logic State Analyzer (LSA) pod assembly 
connects directly above the Emulator pod assembly. The LSA assembly 
includes a pod, cables, and probe clips. The LSA pod provides 16 input 
lines and one trigger output line. 

The one trigger output line behaves the same as the BNC signal on the rear 
panel of the Emulator and can be used with an oscilloscope. 

Figure 5. Logic State Analyzer Pod Assembly 
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Serial Ports 

Both the terminal port ( [terminal! ) and the computer port ( IcomputerI ) end in 
standard RS232C female connectors. Make sure peripheral hardware is 
connected to the correct port. 


Baud Rate Baud rates and data lengths for each port 

are independent. Refer to the SET 
command (page 5-3) for available baud 
rates on each port. 

Port Control Only one port can be the controlling port. 

Either port can give control to the other 
port. 


Upload/Download The Emulator accepts commands to begin 

uploading/downloading from either port. 
However, the Emulator will 
upload/download hex format data files only 
through the computer port. 

Your system configuration determines which port should be in control. 

Refer to page 1-4. 


PIN CONFIGURATIONS 

The pin configuration of your equipment (terminal, PC or host) may not 
match that of the Emulator. It is important to be familiar with the pin 
configurations of all peripheral equipment you intend to use with the 
ESI800 Emulator. 

The ESI800 Emulator is configured as “Data Terminal Equipment” (DTE). 
Before powering up, make sure the ESI800 Emulator system and 
peripheral hardware are compatible. Pins 1, 2, 3 and 7 must be connected 
to peripheral hardware. Pins 4 and 5 need to be connected if peripherals 
attached to the Emulator use these pins. 

Both Emulator serial ports use the same pin assignment. All pin 
assignments and voltage levels conform to Electronics Industries 
Association (EIA) RS232C standards. The following chart lists the signals 
present on each pin. 
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Pin 

Name 

Description 

1 

Protective Ground 

Connected in the Emulator to 
logic ground. 

2 

Serial Data Out 

This signal is driven to nominal 
±12 voltage levels by an RS232C 
compatible driver. 

3 

Serial Data In 

Data is accepted on this pin if the 
voltage levels (±12V) are as 
specified by RS232C 

specifications. 

4 

Request to Send (Output) 

This signal is driven to nominal 
±12V levels by an RS232C 
compatible driver. It signals other 
equipment that the Emulator is 
ready to accept data at this port. 

5 

Clear to Send (Input) 

An input signal to the Emulator 
indicates another piece of 
equipment in the system is ready 
to accept data. This signal is 
terminated so the Emulator 
operates with the signal 
disconnected. 

6 

Not Used 


7 

Signal Ground 

Connected in the Emulator to the 
system logic ground. 

8-25 

Not Used 

These pins are not used by the 
ES1800 Emulator but may be 
required by your peripheral 
hardware. 
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DATA REQUIREMENTS 

Stop Bits The Emulator software transmits and 

receives 8 bit ASCII characters. The 
number of stop bits is determined by SET 
parameter #11 for the Iterminal| port and 
#21 for the IcomputerI port (see page 5-3). 

Parity The Emulator sends and checks parity 

according to system SET parameter #12 for 
the terminal port and #22 for the computer 
port. These two SET parameters are listed 
in the SET MENU (page 5-3). 

Each character consists of a start bit 
followed by 8 data bits. When no data is 
being transmitted, the serial data out pin 
(pin #2) will be at the 12 volt level. 

Hardware Handshake When the Emulator is ready to receive data, 

it asserts the Request To Send line (pin #4). 
When a receive buffer is nearly full, the 
Emulator will deassert the Request To Send 
line. 

When the Emulator is ready to transmit 
data, it checks the status of the Clear To 
Send line (pin #5). Data will only be 
transmitted when Clear To Send is high. 

Software Handshake The ESI800 uses normal flow control codes 

XON XOFF to control software handshaking. The 

default values are XON CTRL Q and XOFF 
CTRL S. These values can be changed by 
the user (see page 5-4). 

The ESI800 serial 1/0 system contains 
internal buffers to smooth the transmission 
of data via the serial ports. If an input 
buffer becomes nearly full, the system 
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immediately transmits an XOFF character. 
When the software empties the input 
buffer, an XON character is transmitted. 

Although the user will never overfill the 
input buffer from a controlling terminal, a 
controlling computer is quite capable of 
doing so. The input buffer for the 
computer port is 64 characters deep. When 
eight characters have been placed in the 
computer input buffer, the XOFF character 
is transmitted. Allowing two character 
times for skew, the computer must transmit 
no more than 54 characters until the next 
XON from the ESI 800. 

The RTS hardware handshake follows the 
software handshake described above. When 
an XOFF is transmitted, RTS is dropped on 
that I/O port; when an XON is transmitted, 
RTS is reasserted. 
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Maintenance 

Maintenance of the ESI800 Emulator has been minimized by the extensive 
use of solid-state components throughout the instrument. There are only 
two areas where you need be concerned. 

CABLES 

The interconnect cables are the most vulnerable part of the instrument, 
due to constant flexing during insertion and extraction. First, inspect the 
cables for any obvious damage, such as cuts, breaks, or tears. Even if you 
have thoroughly inspected the cables and cannot find any damage, there 
may be broken wires within the cables (usually located close to the ends). 
A broken wire within the cable will cause the instrument to run erratically 
or intermittently if the cables are flexed during emulation mode. By 
swapping the cables in question with a known good set of cables, you can 
easily isolate the faulty cable. 

PROBE TIP ASSEMBLY 

The probe tip assembly is the small header assembly that plugs into the 
target system microprocessor socket. The most obvious area to inspect is 
the adapter, as the pins can be broken during insertion or extraction. 

The adapter can be protected by installing a microprocessor socket (male- 
female) onto the adapter. If a pin is then broken on the socket, it is easier 
to replace because of its common usage. 
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PARTS 

The following parts are available for you to order: 


48 pin adapter (68008 chip) 

64 pin adapter (68000/68010 chips) 
114 pin grid adapter (68020 chip) 
Short cable set 
Long cable set 
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Troubleshooting 

Check that the interconnect cables are installed properly in a compatible 
target system, with power applied to both the target system and the 
Emulator before starting troubleshooting procedures. 

The most common problems encountered are listed below. We recommend 
that you contact Customer Service at Applied Microsystems Corporation 
(1-800-426-3925) if you experience any problems that do not fall within 
this range of items. Before you call our service department, display your 
software revision number by typing REV (page 5-135). You will be asked 
for this when you call. 

We do not recommend a component-level repair in the field, unless 
performed by a qualified service engineer. 
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SYMPTOM 


T roubleshooting 

POSSIBLE CAUSES 


Target system 
runs erratically 


Emulator will 
not communicate 
over RS232 


1. Faulty interconnect cables 

2. Broken pin on adapter 

3. Emulator and target system not compatible 

4. LDV not executed before RUN (vector not loaded). 

1. Baud rate set incorrectly. 

2. Target system requires "null 11 modem 
cable (pin 2 and pin 3 of RS232 connector 
reversed). 

3. For terminal operation, thumbwheel switch located 
on the top card is not in the "O" position or 
the cable is not properly attached to the 
terminal port in the back of the ES1800. 

4. Cable not going to correct port of the terminal 
or PC. 

5. Toggle switch located on the second card from the 
top in the ES1800 not in the middle position. 

6. Power LED not on. 

7. Cards not seated properly. 
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ES1800 Emulator Specifications 

INPUT POWER 


Standard 90 to 130 VAC 

47 to 60 Hz 

consumption less than 130W 

Optional 180 to 260 VAC 

47 to 50 Hz 

consumption less than 130W 

ENVIRONMENTAL 


Operating Temperature 
Storage Temperature 
Humidity 


0°C to 40 °C (32 °F to 104 °F) 

-40 °C to 70 °C (-40 °F to 158 # F) 

5% to 95% relative humidity, 
condensing 


PHYSICAL 


Mainframe 


Emulator Pod 


13.2 cm x 43.18 cm. x 34.29 cm. 
(6.2 in. xl7in. x 13.5 in) 

22.6 cm. x 12.9 cm. x 4.1 cm. 
(8.9 in. x 5.1 in. x 1.6 in.) 


non- 


3-20 




Section 3: Hardware 


Target System 
Connection (total 
length including pod) 

LSA Pod 

Total Weight 
Shipping 


1.5 m (60 inches) 

12.4 cm. x 7.9 cm. x 2.3 cm. 
(4.9 in. x 3.1 in. x .9 in.) 

9.1 kg. (20 lbs.) 

10.9 kg. (24 lbs.) 
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ES LANGUAGE 


Structure of the ES Language 

The command language used to control the ESI800 Emulator is a formal 
language. Once you understand the basic concepts of this language, you 
can apply the full debugging power of the Emulator. An overview of the 
structure of the ES language is presented in the accompanying table. A 
more detailed description of the language elements, the help menus, 
prompts, special operating modes, and ES language error messages are also 
included in this section. Items in angle brackets ([o] ) are mandatory and 
must be entered as part of the command. 

Items shown in square brackets (fill) are optional. Do not type the angle 
or square brackets when typing a command. 

If the ESL command interpreter detects an illegal statement, it beeps and 
places a question mark under the command line at the position the error 
was detected. Entering a 0 following an error will cause the appropriate 
error message to be displayed. 
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ES Language Syntax 


Language Element 

Example 

Command Line 

[Repeat] Command Statement [;Command Statement] .. 

. <RETURN> 

Single Character Instant Command 

Repeat 

<*> 

*STP;DT 

<*><Repeat limit> 

*9 STP;DT 

Repeat Limit: 

32 

Decimal number only (l to 2 -1) 

87651234 

Command Statement 

Command Mnemonic 

DTB 

Command Mnemonic <Expression> 

MM PC + 4 

Command Mnemonic <Expression List> 

SET #20,#14 

Assignment Command 

DO = 0FA9 

Expression 

2 * GR5 

Event Monitor System Control Statement 

WHEN AC1 THEN BRK 

Single Character Instant Command 

</> 

<,> 

<.> 

<?> 

Command Mnemonic 

<1 or more alpha characters>[l or more decimal characters] 

Expression 

[Unary Operator] lvalue 

-2473 

lvalue <Operator> Expression 

2 - 3F6C90 

<@> Expression 

a240;aaA7 

<(> Expression <)> 

2 * (-2 + 3) 
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ES Language Syntax (cont) 


Language Element 

Example 

lvalue: 

Symbol 

•main 

Nvalue 

Symbol: 

<’><1 or more printable charactersXspace or return> 

Nvalue: 

Number 

7FA36 

Register Name 

AO 

Register Name: 

<1-3 Alpha characters>[0 - 

2 decimal digits] 

Number: 

[Base]<l or more digits> 

X0101001 

Base: 

<%> (binary) 

<\> (octal) 

<#> (decimal) 

<$> (hexadecimal) 

Expression List 

Expression <,> Expression [,Expression list]. 

1,PC,2+2,-6 

Assignment Command 

Svalue <=> Expression 

A6 = aOFFFFO 

<@> Expression <=> Expression 

3(A6 + 5) = GD3 

Svalue: 

Symbol 

'Test_result 

Register Name 

MMP 
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ES Language Syntax ( cont) 

Language Element 

Example 

Event Monitor System Control Statement 


[Group] <WHE[N]> Event <THE[N]> Action List 

WHEN AC1 THEN BRK 

Group: 


<1> 


<2> 

2 WHE AC1 THE BRK 

<3> 


<4> 


Event: 


[Disjunctive] <Event Comparator> 

NOT AC1 

Event <Conjunctive> <Event> 

DC2 OR NOT AC1 

Disjunctive: 


<NOT> 


Event Comparator 


<AC1>[.Group] 

AC1.3 

<AC2>[.Group] 


<DC1>[.Group] 


<DC2>[.Group] 


<S1>[.Group] 


<S2>[.Group] 


<CL>[.Group] 

CL.4 

<LSA>[.Group] 


Conjunctive: 


<AND> 


<OR> 


Action List 


< Action> [, Action]... 

TRC,TGR,FSI 
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ES Language Syntax (cont) 


Language Element Example 


Action: 

<BRK> 

<TRC> 

<TOT> 

<CNT> 

<TOC> 

<RCT> 

<TGR> 

<FSI> 


<GRO Group> 

GRO 3 

Unary Operator 

<ABS> 

ABS GD3 

<!> 

! OAA 

<-> 

■3 

Operator 

Mul.op 

Add.op 

Shft.op 

<&> 

GD4 & OFF 

<~> 

DC2.3 A OFFOO 

Mul.Op 

<*> 

2*3 

</> 

OFAC / %01001 

<MOD> 

GD5 MOD 7 

Add.op 

<+> 

GRO + A7 

<-> 

3(A7 - 4) 

Shft.op 

A 

A 

A 

V 

DC 1 « 3 


4-5 




ES 1800 Emulator Reference Manual for 68000 Series Microprocessors 


Notes on ESL 

Command Line 


Repeat 


Command Statement 


A command line is created by entering one 
or more characters after the ESL prompt 
(see page 4-27 for a description of the 
various prompts). One or more command 
statements can be placed on a single 
command line. Multiple command 
statements must be separated by a 
semicolon. The command line is limited to 
76 characters and must be terminated with a 
return. The only way to extend command 
lines is by using macros (see page 5-117). 

Backspace or delete characters may be used 
to delete the previous character entered on a 
command line. CTRL X deletes the entire 
line. CTRL R redisplays the current line 
(useful for hardcopy terminals). 

If an asterisk ( 0 ) is the first character on 
the command line, the entire command line 
will be repeated 2 32 times. If the asterisk is 
followed immediately by a decimal number, 
the command will be executed that many 
times. A repeating command line may also 
be terminated by setting the TST register to 
zero within the command line. This 
provides the simple but powerful ability to 
repeat something until a condition is met. 

There are several special modes in which 
the normal command statement rules do not 
apply. In memory mode (see page 6-42), 
entering a [return | on an empty line causes 
the next location to be read. Entering a 
value followed by | return | will cause that 
value to be written to memory. The line 
assembler (see page 6-34), memory 
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Single Character 
Instant Commands 


disassembler (page 6-39), and main help 
menu (page 4-20) all have special modes 
which prevent the normal execution of ESL 
commands. 

These commands are processed immediately 
when they are the first character entered on 
a command line. The forward slash 
character ( @ ) will cause the previously 
entered command line to be repeated. 


>STP 

>/ 

>/ 


This example will single step three times. 

The comma ( □ ) executes macro 1 and the 
period ( Q ) executes macro 2. However, if 
you are in memory mode, the period moves 
you to the next higher memory address 
while the comma moves you to the next 
lower address. 

The question mark ( \t\ ) also has two uses. 
It can be entered after the command 
interpreter detects an error and beeps. If 
you are “beeped,” enter a \?\ and the 
command processor will give you an error 
message describing the problem it detected. 

A \t\ entered at any other time (i.e., not after 
an error), causes a two-page help menu to 
be displayed. A |return| moves you from 
the first page to the second. Any other 
character terminates the help menu. 
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Command Mnemonics 


Expression 


Command mnemonics are the alpha¬ 
numeric character strings that identify a 
specific ESL command. Command 
mnemonics are formed from 1 to 3 alpha 
characters followed by 0 to 2 numeric 
characters. Extra characters in between are 
ignored. For example, IwhenI is the same as 
IwheI and |gr12545| is the same as Igr451 . See the 
Appendices for a list of all ES Language 
mnemonics. 

An expression can be an integer value, an 
alpha/numeric value or an equation. 

Parentheses may be used to alter the normal 
precedence of operations. The Emulator 
recognizes parentheses just as they are 
treated in algebraic equations. As many 
levels of parentheses as needed can be used. 
The only limitation is that statements can be 
no more than 76 characters long. 

Parentheses are not allowed in 
WHEN/THEN clauses. 

The expression processor can resolve 
arbitrarily complex expressions. 


SKGD0 +3) = PC + #100 * (DO » 4) +0AF34 


This example retrieves the value of the DO 
register, shifts it right 4 bit positions 
(divide by 2^), multiplies the result by 100 
decimal, adds 0AF34 and the contents of 
the PC register, and writes the result to the 
location 3 bytes above the address in GD0. 
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A more common and useful example might 
be: 


asm pc + 4 


This computes the address PC + 4, and starts 
up the line assembler at that address. The 
expression: 


■interrupt + 1A6 


by itself will add 1A6 to the current value 
of the symbol interrupt and display the 
result. If you don’t assign the results of an 
expression to a location or register, the 
result is displayed as a 32 bit value. 

The [a] operator is an indirection operator. 
la Exp| (where |exp! is an expression) refers to 
the value in memory at the address |Expl . If 
the [a Exp| is on the left side of an @ then the 
value from the right side of the @ will be 
loaded into memory at the address lExp| . At 
all other times, la Exp| simply reads a value 
from memory, [auspl is a simple way to read 
something from the stack pointer. It is legal 
to have multiple indirections, e.g., 
laaGRO = aaaqjsp + 671 . Byte mode and word 
mode affect the length of data transferred 
to or from the target by the [a] operator. 
(See page 4-27 for more information on 
BYT/WRD/LWM modes.) 

All other math or logic operations are 
evaluated according to the order given in 
the following section on operators. 
Parentheses may be used to alter the normal 
precedence. Unary operations must be 
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enclosed in parentheses if they occur within 
another expression; e.g., |2+-l| is illegal, but 
l2+( -1 )| and M+21 are legal. 

Certain combinations of expression types 
and operators are illegal or have complex 
results. See Results of dyadic operator 
combinations table on page 4-19. 

Some commands can accept a variety of 
argument types. The display block ( DB) 
command accepts an integer, a range, or no 
argument at all. Other commands require 
that a certain argument type be used. The 
upload UPL command requires a range 
argument. See the discussion on Numbers 
(below) for types. 

Symbols If you have the symbolic debug option 

installed in your ESI800 Emulator, you can 
use symbolic references. Every symbol 
must begin with a single quote ( 0 ). 
Symbols are composed of 1 to 64 printable 
characters followed by a space or [return]. 
Symbols can be used anywhere a register or 
a number is used, with the exceptions that 
symbols are not valid with the colon 
operator or the repeat (0 ) operator. 

Numbers The ESI800 has a default base register. It is 

assumed that numbers entered without a 
leading base character are being entered in 
the default base. Generally, the default 
base is hexadecimal (factory default). See 
page 5-85 for more information in 
changing the default base register. 

There are three different types of numbers. 
An integer is a 32 bit signed value. 
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A don’t care is a 32 bit value with a 32 bit 
mask. For each bit set in the mask, the 
corresponding bit position in the value is 
ignored during Event Monitor comparisons. 
Don’t cares can be entered in two ways. 
[1234 dc offo] is explicit. Iixx4[ is equivalent 
to h ff4 dc offo] . Don’t cares are useful for 
setting the Event Monitor System Event 
Comparators (see pages 7-2, 8-2). 

The third number type is range. A range is 
specified by entering a start address and a 
length or an endpoint. I 200 len 20 I is the 
same as I 200 to 21f| . Ranges can be either 
internal (default) or external. An explicit 
range type can be specified by using the 
prefix IRA or XRA. |o len ioo| is the same 
as Iira 0 len 1001 . The 0 operator inverts the 
type of a range value. |! co len 100 TI is the 
same as [xra 0 len ioo| which means 
everything but addresses 1 to OOFF. The 
endpoints are always included in the range. 
Regardless of the method of entering (TO, 
LEN), range values are always displayed as 
“start TO end.” 

Ranges, don’t cares, and integers are not 
generally interchangeable. Certain registers 
can only hold certain data types. All 
registers can hold integers. Address type 
registers cannot be loaded with don’t care 
values. Status and data registers cannot be 
loaded with range values. See page 5-68 for 
a list of all registers and their data types. 

Base To enter a character in any base other than 

the default, use a leading base character: 0 
= binary, 0 = octal, [#] = decimal, and ® = 
hexadecimal. 
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Expression List 


Assignment Command 


Lists are required by a few commands. 
They can also be used for implicit 
evaluation. For example, in pause mode, 
entering the three numbers 
l%oiooiioio f #128, \ 77347j causes the Emulator 
to display their equivalent in the default 
display base (usually hexadecimal). Lists 
are limited to nine elements. Lists are used 
in memory mode as well. 

Svalues are the names of registers or 
symbolic references. The form 
^Expression = Expression] will cause the left 
side expression to be calculated and used as 
an address at which to store the value of the 
right side expression. Note that since 
[aExpression[ is itself an expression, 
commands such as laA7 = ol are legal and 
useful. 

The following example assigns the value on 
the right ($47FF) to the A0 register. 


A0 = $47FF 


The Emulator displays nothing in response 
to this entry. 

Verify by: 


>A0 

S000047FF 


In the following example the expression 
$121 + $4 is calculated. 
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ao = $121 + $4 


The register AO is then assigned the value 
$125. Your console screen will not display 
this entry. Verify by: 


>A0 

$125 


Registers are grouped into three types: 
integer only, don’t care, and range. Any 
register can be assigned an integer value. 
Don’t care registers can be loaded with 
don’t care values or integers but not ranges. 
Range registers can be loaded with integers 
or ranges but not don’t care values. See 
page 5-68 for a list of all registers and their 
data types. 

The indirection operator [a] allows 
expressions to include values transferred to 
or from the target system memory address 
space. The expression becomes the address 
of a target system byte, word, or long word. 

More than one [a] operator in an expression 
displays a quantity pointed to by another 
quantity located in the target system 
memory. The Emulator evaluates the 
expression following the [a] operators, 
considers it an address, and looks at the 
value stored at this address. The value at 
this address is also considered to be an 
address. This address is accessed and 
displayed. 

Parentheses may be used to affect the 
processing of the [a) operator: 
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Event Monitor System 
Control Statement 


>a GD4 + 6 
>3 (GD4 + 6) 


In the first example the indirection operator 
is applied to [GD4l . The command interpreter 
accesses the target system location pointed 
at by |GD4| , adds six to the value stored there, 
and displays the final results. 

In the second example, the Emulator 
displays the value stored in the sixth 
location above the address pointed to by 

|GD41 . 


Memory mode always executes memory 
reads. This may be unacceptable for certain 
hardware configurations. To store values 
without entering memory mode, use: 


>3 <address> = <data> 


This causes the system to load data into the 
specified address. 

Event Monitor System statements describe 
combinations of target program conditions 
and the corresponding actions to be taken if 
the conditions are met, not mathematical or 
logical computations. Be aware that normal 
expression operators are illegal when 
specifying Event Monitor System 
statements. These statements are discussed 
in detail in Section 7 (68000/08/10) or 
Section 8 (68020), Event Monitor System. 


4-14 





Section 4: ES Language 


Group The Event Monitor System (EMS) is 

arranged in four independent groups. 
These groups provide a state-machine 
capability for debugging difficult 
problems. An EMS control statement can 
only be associated with one of the four 
groups. If no group numbers are mentioned 
in the EMS control statement, the statement 
is assigned to group 1. There are two ways 
to override this default selection of group 1. 
You can begin the EMS control statement 
with a group number, or you can append a 
group number to any one of the event 
comparator names. For example: 
|3 when aci then brk| is functionally the same 
as [when aci.3 then brk| ; both use group 3. 
You cannot mix group numbers within a 
single EMS control statement. 

Event You can define an event to be some 

combination of address, data, status, count 
and logic state probe conditions. Numerous 
Event Monitor System control statements 
can be entered and will be in effect 
simultaneously. Conflicting statements may 
cause unpredictable action processing. 
Parentheses are not allowed in event 
specifications. 

Disjunctive The NOT operator is used to reverse the 

sense of the comparator output. NOT has 
higher precedence than either of the 
conjunctives, AND and OR. 


UHEN ACI AND NOT DC1 THEN BRK 


This statement means break whenever any 
data pattern other than that in DC1 is 
written to the address in ACI. 
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Conjunctive 


Unary Operator 


AND and OR can be used where needed to 
form more restrictive event definitions. 
AND terms have higher precedence than 
OR terms. 


AC1 AND DC1 OR DC2 


This event is equivalent to Iaci and dcT| in 
one statement and [dc2] in another. If you 
are looking for two different data values at 
an address, you would use: 


AC1 AND DC1 OR AC1 AND DC2 


The OR operator is evaluated left to right 
and is useful for simple comparator 
combinations. For complex event 
specifications, OR combinations can be 
replaced with separate EMS control 
statements for clarity. 


AC1 AND SI OR AC2 AND S2 


This event is the same as [aci and si] and 
[ac2 and S2l in separate statements. 

All internal computations use 32 bit math. 
Values entered with a leading 0 are 
converted to signed numbers; e.g., [Tj is 
stored internally as |$ffffffff| . Internal math 
however, is signed only for the 0, 0, 0, 0 
operations; 1-5+31 is IsfffffffeL while [-1 » il 
is reduced to |$7fffffff[ . 
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Operator 


Modulo ('MOD) 


ABS converts a signed number to its 
absolute value. 

0 is a logical NOT operator and 
compliments all 32 bits of a number. If the 
number is a range, the range type (internal 
or external) is inverted. 

Unary operators have the highest 
precedence. |-2+3| is 1. 

The operators are listed below in 
descending order of precedence. Operators 
of the same type are evaluated left to right. 


Mul.op: 

* 

Multiply 

/ 

Divide 

MOD 

Modulo 

Add.op: 

+ 

Add 

- 

Subtract 

Shft.op: 

» 

Right shift 

« 

Left shift 

& 

Logical AND 

- 

Logical OR 


The result of this operation is the remainder 
after the value on the left has been divided 
by the value on the right. For example, 
1>29 mod ~4l results in 1. 
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Results of Single-Argument Operators 


Operator 

Argument 

Result 

! 

Integer 

Valid 


DC 

Don’t care bits are not affected. 


IRA 

Complement (IRA becomes XRA) 

ABS 

Integer 

Valid 


DC 

Don’t care bits are not affected. 


IRA 

Invalid 


XRA 

Invalid 

- 

Integer 

Valid 


DC 

Don’t care bits are not affected. 


IRA 

Invalid 


XRA 

Invalid 

@ 

Integer 

Valid 


DC 

Invalid 


IRA 

Invalid 


XRA 

Invalid 
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Results of Dyadic Operator Combinations 


Left Hand 

Right Hand 



Expression 

Expression 

Operator 

Result 

Integer 

Integer 

* / MOD 

Valid 



& * 

Valid 



« » 

Valid 



+ - 

Valid 

Integer 

Don’t care 

MOD 

Illegal 



*/ 

Don’t care bits are passed to 
the left hand argument. 



& ~ 

Don’t care bits are passed to 
the left hand argument. 



« » 

Don’t care bits are passed to 
the left hand argument. 

Integer 

IRA XRA 

* / MOD 

Invalid 



& ~ 

Invalid 



« » 

Invalid 



+ - 

The endpoints of the range will 
be altered by the value of the 
integer expression. 

Don’t care 

Don’t care 

* / MOD 

Invalid 



& A 

Invalid 



« >> 

Invalid 



+ - 

Don’t care bits are ANDed. 

Don’t care 

Integer 

* / MOD 

Don’t care bits are kept. 



& ~ 

Valid 



« » 

Don’t care bit positions are 
shifted. 



+ - 

Don’t care bits are kept 

IRA, XRA 

Integer 

* / MOD 

Invalid 



& ~ 

Invalid 



« » 

Invalid 



+ - 

The end points of the range 


will be altered by the value of 
the integer expressed. 
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Help 

There are two pages of help information available. The 68020 help menu 
differs from the 68000/08/10 menu. Enter a [?] as the first character of a 
command line to display the first help page. This page gives examples of 
the most commonly used commands and their meanings. The second page 
describes the Event Monitor System registers and commands. Enter a 
[return 1 at the end of the first page to move to the second page. The 
menus are shown on the next four pages. 

Other help menus provide information on switch settings, configuration 
settings, and special functions is available without using the help menus. 
These menus are described below. 

Enter either [on] or [off] to display the 
current settings and definitions of all 
software switches, (see page 5-9). 

Enter [set! to display the current 
configuration settings and possible values 
(see page 5-3). 

Enter [sf] to display a list of the available 
special functions (RAM/ROM tests, scope 
loops, etc.) (see page 6-50). 


Software Switches 


Communications 

Set-up 


Special Diagnostic 
Functions 
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First Page of Help Menu (68000/08/10) 

>? 

RUN/EMULATION: 

STP - SINGLE STEP/STOP 

RST - RESET TARGET SYSTEM 

RUN/RNV - RUN/RUN WITH NEW VECTORS 
RBK/RBV - RUN TO BREAKPOINT/WITH VECTORS 
WAIT - WAIT UNTIL EMULATION BREAK 

TRACE HISTORY: 

DT - DISASSEMBLE MOST RECENT LINE 

DTB/DTF-DISASSEMBLE PAGE BACK/FORWARD 

DRT (X)-DISPLAY PAGE RAW TRACE (FROM X) 

MEMORY - REGISTER COMMANDS: 

DB X TO Y - DISPLAY BLOCK 

BMO X TO Y, Z • BLOCK MOVE TO Z 
MMS = ALT, COD, DAT, STA 

X - EXIT MEMORY MODE 

DR - DISPLAY ALL CPU REGISTERS 

FILL X TO Y, Z - FILL BLOCK WITH Z 
LOV/VFO X TO Y - LOAD/VERIFY OVERLAY 

DEFINES STATUS LINES FOR MEMORY ACCESS 

M X - VIEW/CHANGE MEMORY AT X 

MEMORY MAPPING: 

MAP X TO Y :RO :RW :TGT :ILG 

OVE = DC, DAT 

DM/CLM - DISPLAY/CLEAR MEMORY MAP 

COMMUNICATIONS: 

DNL - DOWNLOAD HEX FILE FROM HOST 

UPL X TO Y - UPLOAD HEX TO HOST 

TRA - TRANSPARENT MODE TERMINAL-HOST 

CCT - TRANSFER CONTROL TO COMPUTER PORT 
TCT - TRANSFER CONTROL TO TERMINAL PORT 

SYSTEM: 

ON/OFF - VIEW/ALTER SWITCHES 

ASM (X) - IN LINE ASSEMBLER 

LD/SAV (X) - LOAD/SAVE 0=SETUP, 1- 

SET - VIEW/ALTER SYSTEM PARAMETERS 

SF - VIEW/EXECUTE SPECIAL FUNCTIONS 
DIS(X) DISASSEMBLE FROM MEMORY 
■REGS,2-EVENTS,3=MAP,4=SWITCHES,5=MACROS 
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Second Page of Help Menu (68000/08/10) 


EVENT MONITOR SYSTEM 

DES - DISPLAY ALL EVENT SPECIFICATIONS 

CES - CLEAR ALL EVENT SPECIFICATIONS 

DES X - DISPLAY ALL EVENT SPECIFICATIONS FOR GROUP X 

CES X - CLEAR ALL EVENT SPECIFICATIONS FOR GROUP X 

EVENT ACTIONS: 

BRK - BREAK CNT - COUNT EVENT 

TRC - TRACE EVENT RCT - RESET COUNTER 

TOT - TOGGLE TRACE TOC - TOGGLE COUNT 

EVENT DETECTORS - GROUPS 1, 2, 3, 4: 

AC1,AC2 OR AC1.X,AC2.X - 24-BIT DISCRETE ADDRESS OR INTERNAL EXTERNAL RANGE 
DC1,DC2 OR DC1.X,DC2.X - 16-BIT DATA, MAY INCLUDE DON'T CARE BITS 
Si,S2 OR S1.X,S2.X - STATUS AND CONTROL - BYT/WRD + RD/WR + TAR/OVL 

+ MEM/IOA + IAK/RIO/WIO/HLT/IF/RM/WM/NBC 
+ ALT/COD/DAT/STA 

LSA - 16 LOGIC STATE LINES, MAY INCLUDE DON'T CARE BITS 

CL - COUNT LIMIT, ANY NUMBER 1 TO 65,535 

STEP 1 - ASSIGN EVENT DETECTORS 
STEP 2 - CREATE EVENT SPECIFICATIONS 

AC1 = $1234;Si = BYT + RM WHEN AC1 AND Si THEN GROUP 2 

AC1.2 = $4576+14*6;DC2.2 = $5600 DC $FF 2 WHEN AC1 AND NOT DC2 THEN CNT 
CL.2 - 24;AC2.2 = $F000 LEN $400 WHEN CL.2 OR AC2.2 THEN BRK 


TGR - TTL TRIGGER STROBE 

FSI - FORCE SPECIAL INTERRUPT 

GROUP X - SWITCH TO GROUP X 
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First Page of Help Menu (68020) 

>? 

RUN/EMULATION: 

STP - SINGLE STEP/STOP 

RST - RESET TARGET SYSTEM 

RUN/RNV - RUN/RUN WITH NEW VECTORS 

RBK/RBV - RUN TO BREAKPOINT/WITH VECTORS 
WAIT - WAIT UNTIL EMULATION BREAK 

TRACE HISTORY: 

DRT X TO Y - DISPLAY TRACE RANGE 

DRT (X)-DISPLAY PAGE RAW TRACE (FROM X) 

MEMORY - REGISTER COMMANDS: 

DB C.BWL) X TO Y - DISPLAY BLOCK 

FIL X TO Y,Z - FILL BLOCK WITH Z 

BMO X TO Y,Z - BLOCK MOVE TO Z 

VBM X TO Y,Z - VERIFY BLOCK MOVE 

M (X) - VIEW/CHANGE MEMORY (AT X) 
MMS/MMD = SC0-SC7,SP,SD # UP,UD f CPU 

DR - DISPLAY ALL CPU REGISTERS 

CLR - CLEAR ADDRESS AND DATA REGISTERS 
VBL X TO Y,Z - VERIFY BLOCK CONTAINS Z 
LOV/VFO X TO Y - LOAD/VERIFY OVERLAY 

X - EXIT MEMORY MODE 

.B,.W,.L ■ DATA LENGTH; BYTE, WORD, LONG 
STATUS FOR MEMORY ACCESS; SOURCE/DEST 

COMMUNICATIONS: 

DNL - DOWNLOAD HEX FILE FROM HOST 

UPL X TO Y - UPLOAD HEX TO HOST 

TRA - TRANSPARENT MODE TERMINAL-HOST 

CCT - TRANSFER CONTROL TO COMPUTER PORT 
TCT - TRANSFER CONTROL TO TERMINAL PORT 

SYSTEM: 

BUS - VIEW HARDWARE STATUS LINES 
ON/OFF - VIEW/ALTER SWITCHES 
MAC/CMC - DISPLAY/CLEAR MACROS 
LD/SAV (X) - LOAD/SAVE 0=SETUP,1- 

SET - VIEW/ALTER SYSTEM PARAMETERS 

SZ (.BWL) - SET DEFAULT DATA LENGTH 

SF - VIEW/EXECUTE SPECIAL FUNCTIONS 
DIS/ASM (X) DIS/ASSEMBLE FROM/TO MEMORY 
REGS,2-EVENTS,3=MAP,4=SWITCHES,5=MACROS 
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Second Page of Help Menu (68020) 


MEMORY MAPPING: OVE = SCO-SC7+SP+SD+UP+US+CPU; OVS = 2-5 

MAP X TO Y :R0 :RW :TGT :I LG DM/CLM - DISPLAY/CLEAR MEMORY MAP 

EVENT MONITOR SYSTEM 

DES/CES (X) - DISPLAY/CLEAR ALL EVENT SPECIFICATIONS (FOR GROUP X) 

EVENT ACTIONS: 


BRK 

- BREAK 

CNT 

- COUNT EVENT 

TGR 

- TTL TRIGGER STROBE 

TRC 

- TRACE EVENT 

RCT 

- RESET COUNTER 

FSI 

- FORCE SPECIAL INTERRUPT 

TOT 

- TOGGLE TRACE 

TOC 

- TOGGLE COUNT 

GROUP X 

- SWITCH TO GROUP X 


EVENT DETECTORS - GROUPS 1,2,3,4: 

AC1,AC2 OR AC1.X,AC2.X - 24 BIT DISCRETE ADDRESS OR INTERNAL EXTERNAL RANGE 

DC1,DC2 OR DC1.X,DC2.X - 16 BIT DATA, MAY INCLUDE DON'T CARE BITS 

S1,S2 OR S1.X,S2.X - STATUS AND CONTROL - BYT/WRD + RD/WR + TAR/OVL 

+ SP/SD/UP/UD/SCO-SC7 + IPO .. IP7 + BER _ AV + IP 
LSA - 16 LOGIC STATE LINES, MAY INCLUDE DON'T CARE BITS 

CL - COUNT LIMIT, ANY NUMBER 1 TO 65,535 

STEP 1 - ASSIGN EVENT DETECTORS STEP 2 - CREATE EVENT SPECIFICATIONS 

AC1 = $1234;S1 = SP + RD WHEN AC1 AND Si THEN GROUP 2 

AC1.2 = $4576+14*6;DC2.2 = $5600 DC $FF WHEN AC1 AND NOT DC2 THEN CNT 

CL.2 - 24;AC2.2 = $F000 LEN $400 WHEN C<.2 OR AC2.2 THEN BRK 
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Log In Banner 

After initial power on, the log in banner should appear on your console 
screen. After a reset, the first three lines of the banner appear on your 
screen. 


COPYRIGHT 1985 

APPLIED MICROSYSTEMS CORPORATION 
SATELLITE EMULATOR 68XXX VX.XX 

USER = _ SW= _ 

# K AVAILABLE OVERLAY 


The microprocessor type is that of the 
target system. Refer to the Motorola 
reference manual for more information. 

The version number reflects the released 
version of the ES language software for the 
emulator. 

The user number and software number (SW) 
indicate the positioning of the thumbwheel 
switch on the Emulator main control board 
(refer to page 3-5). 

The amount of overlay memory indicated 
depends on the amount installed in the 
system. This can be 32, 64, 128, 256 or 512 
K of memory. 

>No Target VCC The console screen displays a NO TARGET 

YCC (see error message page B-3) when 
you are not connected to a target system. 

A CTRL Z clears this display message and 
returns the system to the log in banner for 
reentry of an input command. 


#_ K AVAILABLE 

OVERLAY 


Satellite Emulator 
68XXX 

VX.XX 

USER= SW= 
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NOTE: Refer to page 3-10 Null Target System Simulation Tool, for using 
the ESI800 Emulator without a target system. 


Prompt 


If the > does not 
appear after the log in 
banner: 


The pause mode prompt 0 indicates that 
the Emulator is not running, is in a pause 
mode and is ready to receive instructions. 
Make sure that the 0 shows before you 
enter any command. 

Turn off the equipment, check the 
connections, and then repeat the power-up 
sequence. 

Check for proper connection of the cable 
between the CRT and the Emulator. 

Check the cable connecting the pod to the 
Emulator. Is it completely secured? 

Check to see if the pod probe package is 
completely plugged into the target system. 

If the unit has just been shipped, one or 
more of the boards may have become loose 
in the Emulator chassis. Check for loose 
boards. 


If an error message appears, refer to the given message in Appendix B. 
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Prompts 

Different prompts are displayed depending on the current operating mode 
of the ES1800. 


> 


R> 


The standard, or pause mode prompt from 
ESL consists of a space character followed 
by a right arrow. 

During emulation, the run mode prompt is 
displayed. Most ESL commands are still 
valid. 


$12345678 $00 > 
$12345678 $00 R> 
$12345678 $0000 > 
$12345678 $0000 R> 


In memory mode, the prompt includes the 
memory address and the data contained 
there. Depending on whether byte mode, 
word mode, or long word mode (BYM, 
WDM, LWM) has been chosen, the data will 
be a byte, a word or a long word. The 
“run” prompt (|r>]) may also be present 
during memory mode. 


$000000 $FF> These three memory mode prompts will 

$000000 $FFFF> display to indicate whether the system is in 

$000000 $FFFFFFFF> an 8 bit, 16 bit or 32 bit mode, respectively, 

for displaying your address and data. 


**** 680XX LINE ASSEMBLER **** 

000100 > The 68000/08/10 line assembler displays a 

16 bit address prompt. The 68020 line 
assembler displays a 32 bit address. This 
prompt contains an [r] if you are assembling 
during emulation. 


4-27 



ES 1800 Emulator Reference Manual for 68000 Series Microprocessors 


Special Modes 

There are a few special modes you can enter, some of which must be exited 
before using regular ESL commands. Most of these modes can be 
identified by the prompt displayed, or lack thereof. 

Byte Mode/ The BYM, WDM and LWM commands 

Word Mode/ select byte, word and long word mode 

Long Word Mode operation. The mode selected determines 

whether 8, 16 or 32 bit data is used or 
displayed. If byte mode is set, most data 
commands use byte values, and the 
indirection operator reads a byte from the 
address given. The same is true of word 
and long word modes. 

More compatible with the Motorola style of 
value display is the SZ command. To 
designate globally what memory address 
and data pattern the system will display 
enter the SZ mnemonic, specify the mode 
with a dot operator and press return: 
|S2 <.B,.W,.L>1 

Memory address and data patterns will 
globally display in the specified mode: |sz.b| 
displays in byte mode. |sz.u| displays in 
word mode. Isz.lI displays in long word 
mode. 

You can temporarily override the byte, 
word and long word address and data 
display prompts by keying in the dot 
operators ([7b], [7w] , [7l| ) after a command. 
For example: |db.b| means a block of 
memory is displayed in byte mode. |db.m| 
means a block of memory is displayed in 
word mode. Idb.lI means a block of memory 
is displayed in long word mode. 
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Line Assembler 


Memory Disassembler 


Memory Mode 
Transparent Mode 


Special Functions 


The dot operators may also be used with the 
indirection operator (g ) e.g. [a. b(183+1)1 . 

When the indirection operator is used ([a]), 
long word mode is the dot operator default 
extension regardless of the system default 
mode. To change this you must specify [7b] 
or [Tw| . 

The 68000/08/10 line assembler has a single 
16 bit address prompt. The 68020 line 
assembler has a 32 bit prompt. Exit by 
entering an [x] or the END directive. 

If initiated without a range argument, the 
memory disassembler (DIS) displays a full 
page of data, leaving the cursor at the lower 
right corner of the screen. A | return 1 
displays the next page of disassembled 
memory. A [spaceI causes only the next 
instruction to be disassembled. Any other 
character terminates memory disassembly. 

Memory mode has an address and data 
prompt. Exit by entering an [x]. 

No characters are generated by the ESI800. 
Exit by entering the two character escape 
sequence (default is |esc[ |esc| ), or reset 
(default [cTrl] [z] ). 

Many diagnostic functions are designed to 
run continuously. The message from the 
function will inform you to enter the reset 
character (default is |ctrl| [zj ) to terminate 
the function. 
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Repeating Command 
Lines 


It is easy to create an indefinitely repeating 
command that does not display anything. 
Terminate such commands with the reset 
character (default is [CTRL] [z] ). 
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Special Characters 


DELETE 

BACKSPACE Either character deletes a character just 

entered on a command line. 


CTRL X 


Deletes an entire command line. 


CTRLR 

CTRLZ 


ESC ESC 


CTRL S 


CTRLQ 


Redisplays the current command line (for 
hardcopy terminals). 

The default reset character. The reset 
character can be changed by the user (see 
page 5-3). 

The default transparent mode escape 
sequence, used to terminate transparent 
mode. The transparent mode escape 
sequence can be changed by the user (see 
page 5-3). 

The XOFF character. When issued from 
the keyboard, the screen display stops 
scrolling, allowing the user to view the 
information. The XOFF character can be 
changed by the user (see page 5-3). 

The XON character. Restarts the screen 
display after an XOFF is issued. The XON 
character can be changed by the user (see 
page 5-3). 
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Errors 

The ESI800 software generates two basic types of error messages. ES 
Language syntax and operational errors in a command line are indicated by 
a beep (BEL code). The next line displayed contains a single [t] 
underneath, and usually just after, the place in your command line that 
caused the error. At the point the error is detected, the remainder of the 
command line is discarded. For example, the DRT command is invalid 
during emulation: 


>WHE AC1 THE BRK; RBK; DRT; DR 
<BEL> ? 

R> 


The RBK command was executed, but the DR command was not. 
Whenever you see an error message of this type, you can enter a single [?]. 
The ESI800 responds with a text message explaining the error. For the 
above example: 


R>? 

ERROR #56 

TRACE DATA IS INVALID DURING EMULATION 
R> 


These error messages are described in this section. The second type of 
error message is caused by target hardware problems. There are various 
conditions that can occur in the target that prevent the pod processor from 
operating. If these error messages are displayed, the problem must be 
remedied before the ESI800 can be used. The error messages are quite 
explicit: e.g., [no target clockI or [reset asserted] . Target hardware error 
messages are explained in Appendix B. 
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ES Language Error Messages 

1,2,3 EXPRESSION HAS NO MEANINGFUL 

RELATION TO REST OF COMMAND. 
Often caused by entering symbols out of 
context, [dr] and |brk| are both legal, but 
when entered together as Idr brk| cause this 
error message. 

4 PARSE ERROR. . .CALL AMC.. 

5 UNDEFINED SYMBOL OR INVALID 

CHARACTER DETECTED. Usually 
caused by improper spelling. 

6 CHECKSUM ERROR IN DOWNLOAD 

DATA. The last record received was in 
error. Make sure that the format selected in 
the system setup is the same as the format 
of the received data. Refer to download 
command (DNL) for error handling during 
computer control. 

7 BAD STATUS = ...RETURNED FROM 

EMULATOR CARD. Contact Customer 
Service. 

8 ARGUMENT IS NOT A SIMPLE 

INTEGER OR INTERNAL RANGE. 
Don’t cares are not allowed in this context. 

9 NO MORE OVERLAY MEMORY 

AVAILABLE. You have not cleared the 
map or you are trying to map in more 
memory than is allowed. Contact Applied 
Microsystems Corporation for optional 
overlay memory expansion. 
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10 MULTIPLE-DEFINED EVENT GROUP. 

Only one group may be referenced in any 
event clause. Error is caused by trying to 
mix event register groups in an event clause 
(e.g., |2 when ACi.5 then brk] would cause this 
error). 

11 ILLEGAL ARGUMENT TYPE FOR 

EVENT SPECIFICATION. Only the 8 
event comparators may be used in the event 
portion of a WHEN/THEN statement. 

12,13 ARGUMENTS MUST BE A SIMPLE 

INTEGER. Don’t care masks and ranges 
not allowed. 

14,15,16 OPERATION INVALID FOR THESE 

ARGUMENT TYPES. Usually caused by 
attempting arithmetic operations on 
incompatible variables (e.g., 
1(4 dc 9) + (IRA 500 to 700))] . (Same as error 
23.) 

17 SHIFT ARGUMENT CANNOT BE 

NEGATIVE. To shift a value in the reverse 
direction, use the opposite shift operator, 
( [>>1 or R<1), not a negative shift value. 

18 TOO MANY ARGUMENTS IN LIST ... (9 

MAX). When entering data in memory, a 
list of only 9 values can be entered on a 
single command line. 

19 INVALID GROUP NUMBER . . . (NOT IN 

1-4). There are only four event groups 
(1-4). 
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20,21,22,23 OPERATION INVALID FOR THESE 

ARGUMENT TYPES. Often caused by 
attempting arithmetic operations on 
incompatible variables. 

24 BASE ARGUMENT MUST BE A SIMPLE 

INTEGER. Argument should be #0 to #16. 

25 ILLEGAL OVS VALUE . . . (NOT IN 1 -7). 

Overlay speed determines the number of 
wait states inserted for overlay accesses. 
Only 1-7 are allowed. 

26 RANGE TYPE ARGUMENT NOT 

ALLOWED AS DATA. Data can only be 
expressed as masked values or integers. 

27 ADDRESS ARGUMENT MUST BE A 

SIMPLE INTEGER. Cannot use ranges or 
masked values. 

28 ATTEMPT TO CHANGE CURRENT 

OVERLAY SEGMENT (USE ‘CLM’ 
FIRST). Overlay memory can only be 
mapped within a a 16 megabyte range. 

29 ILLEGAL DESTINATION - SOURCE 

TYPE MIX. Caused by trying to store don’t 
care data into a range variable or other 
similar operations. 

30,31 RANGE START AND END 

ARGUMENTS MUST BE SIMPLE 
INTEGERS. Cannot use masked values or 
ranges. 

32 RANGE END MUST BE GREATER 

THAN RANGE START. |6 len il and 
ho to 5| are examples of invalid ranges. 
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33 


34 


35 


36 , 37,38 


39 


RANGE START AND END 
ARGUMENTS MUST BE SIMPLE 
INTEGERS. Cannot use masked values or 
ranges. 

READ AFTER WRITE-VERIFY ERROR. 
Data supposedly written to memory during 
a download operation was read back as a 
different value. The error message contains 
the locations and results of the comparison. 

WARNING - DATA WILL BE LOST 
WHEN EMULATION IS BROKEN. 
Caused by assigning values to CPU registers 
during emulation. CPU registers are copied 
into internal RAM only when emulation is 
broken. The RAM contents are copied into 
the processor only when emulation is 
begun. The Emulator cannot access CPU 
registers during emulation. Thus, once 
emulation has been started the DR 
command shows the contents of the CPU 
registers as they were before emulation was 
begun. Changes can be made to these 
values, but the data will be rewritten when 
emulation is broken. 

NO ROOM . . . BREAKPOINT CLAUSES 
TOO NUMEROUS OR COMPLEX. Too 
many WHEN/THEN clauses were entered. 
The number of sentences cannot exceed the 
available RAM in ESL. This is different 
for each of the microprocessors supported. 

INVALID GROUP NUMBER . . . (NOT IN 
1-4). There are only four groups in the 
Event Monitor System. 
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40 


41 


42 

43 


44 

45 


46 


47 

48 

49,50 

51 


ILLEGAL SELECT VALUE. Variable 
cannot be assigned value specified. Check 
manual. 

INCORRECT NUMBER OF 
ARGUMENTS IN LIST. Check command 
argument list. 

ILLEGAL SETUP SET VALUE. Consult 
SET menu for legal values (page 5-3). 

"WHEN" CLAUSE REDUCED TO NULL 
FUNCTION. Caused by constructs such as 

|WHEN AC1 AND NOT ACf| . 

INTERNAL ERROR . . . NULL SHIFTER 
FILE. Contact Customer Service. 

MAP CANNOT BE ACCESSED DURING 
EMULATION. The map hardware is 
constantly used by the emulating processor 
during emulation and cannot be accessed. 

ARGUMENT MUST BE AN INTERNAL 
RANGE. External ranges and masked 
values not allowed. 

16-BIT RANGE END LESS THAN 
START. Invalid range. 

ILLEGAL MODE SELECT VALUE. 

INVALID GROUP NUMBER . . . (NOT IN 
1-4). Must be 1 through 4. 

SAVE/LOAD INVALID ARGUMENT 
VALUE. Valid arguments include 0 
through 5. 
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53 EEPROM WRITE VERIFY ERROR. Data 

in the EEPROM is verified during the SAV 
operation. (The store operation is retried 
many times before this error is generated.) 
EEPROMs have a finite write cycle life. 
The EEPROM in your Emulator is 
warrantied for one year. Contact Customer 
Service. 

54 ATTEMPT TO SAVE/LOAD DURING 

EMULATION. These commands may only 
be used while in the pause mode. 

55 EEPROM DATA INVALID DUE TO 

INTERRUPTED SAVE. Previous SAV 
command was interrupted by a reset or 
power off. 

56 TRACE DATA IS INVALID DURING 

EMULATION. Viewing of the trace is 
only allowed during pause mode. 

57 (INVALID GROUP NUMBER (NOT 1-4). 

Must use 1 - 4. 

58 IMPROPER NUMBER OF ARGUMENTS. 

Check command argument list. 

59 ARGUMENT MUST BE AN INTERNAL 

RANGE. External ranges and masked 
values not allowed. 

60 ARGUMENT MUST BE A SIMPLE 

INTEGER. Ranges and don’t care masks 
not allowed. 

61 IMPROPER NUMBER OF ARGUMENTS. 

Check command argument list. 
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62 CANNOT STORE THIS VARIABLE 

DURING EMULATION. Must be in pause 
mode. 

63 ILLEGAL ARGUMENT TYPE. 

64 ARGUMENT TOO LARGE. Caused by 

entering DRT argument that includes 
numbers greater than #2045. 

65 ILLEGAL RANGE. 

66 STATUS CONSTANTS CANNOT BE 

ALTERED. System constants (i.e., BYT, 
OVL) cannot be assigned values. 

67 TOO MANY "WHEN" CLAUSES. You 

have tried to enter more WHEN/THEN 
clauses than the Event Monitor System can 
handle. 

68 INVALID DATA FORMAT FOR 

SYMBOLS. Must use Extended Tektronix 
Hex. 

70 CANNOT INITIALIZE VECTORS 

DURING EMULATION, [ldv], [rnv], -and 
IrbvI can only be entered in pause mode. 

71 MUST BE IN TRACE MODE 2 TO 

DISASSEMBLE TRACE. Refer to SET 
menu and rerun in trace mode 2 before 
using DTB(3). 

72 INCOMPATIBLE EEPROM DATA. 

Previous data saved to EEPROM was not 
from an 680XX Emulator system. 
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74 

75 

76 


78,79,80 


81 


82 


83 


87 

88 

89 


COMMAND INVALID DURING 
EMULATION. Must be in pause mode. 

INVALID RECORD TYPE. Download 
routine received invalid record type code. 

NO SYMBOLIC DEBUG. The symbolic 
debug option is not installed in your system. 
Cannot assign symbol and section values. 

TOO MANY SYMBOLS. Symbols 
exceeded available RAM. Purge symbols 
before downloading again. 

SYMBOL OR SECTION PREVIOUSLY 
DEFINED. An attempt was made to 
redefine an existing symbol or section. 
Section definitions cannot overlap. 
Symbols should be purged before 
downloading. 

SYMBOL NAME IN USE. Symbol name 
cannot be used more than once. You must 
delete a section before assigning it a new 
value. 

TYPE CONFLICT WITH DEFINED 
SYMBOL. Please refer to Extended Tekhex 
specification, page C-7. 

SECTION TABLE FULL. Too many 
symbolic section names have been defined. 

INVALID ARGUMENT SIZE. Operand 
doesn’t fit into destination register. 

INVALID ADDRESSING MODE. 


4-40 



Section 4: ES Language 


90 ARGUMENT OUT OF RANGE. 

91 INVALID TRAP VECTOR NUMBER. 

92 INVALID OP CODE for 68000/08/10.. 

93 INVALID CONTROL REGISTER. 

94 ARGUMENT NOT SYMBOLIC. [del] 

Requires a symbolic argument. 

95 ILLEGAL SPACE CODE. 


255 


UNKNOWN ERROR. 
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Section 5 


SYSTEM COMMANDS 


Set-Up Commands 

The SET and ON/OFF commands allow you to configure the ESI800 
according to hardware and debugging needs. There are two menus con¬ 
taining variables that are software selectable for quick and easy changes. 

The SET menu contains all of the external communication variables such 
as baud rates, parity, and upload/download data format. Some set param¬ 
eters require a reset before becoming effective. You can also set the serial 
communication parameters and save them to EEPROM without affecting 
the parameters currently in use. 

The ON/OFF menu contains switches that control emulation and the serial 
port copy switch. For example, the copy switch copies data to both serial 
ports for obtaining hard copy of your emulation session. 

The SET menu and the ON/OFF menu can be saved to EEPROM after you 
have set them. These values may then be automatically loaded into the 
Emulator on power-up by setting the thumbwheel switch to the 
appropriate value, or manually by typing a load command (LD) to the 
Emulator after power-up. 

The EEPROM is divided into two groups of six sections. Each section 
within a group may be loaded and saved individually. The two Groups 
designate two users, referred to as User 0 or User 1 in the SET menu. This 
allows two users to save complete information about their emulation ses¬ 
sion, and reload it later. The six sections of information are: 
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Group # Description 

0 SET menu 

1 Registers 

Event Monitor WHEN/THEN clauses 
Overlay map 
ON/OFF menu 
5 Macros 
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SET COMMAND 


Command 


Result 


SET Displays the SET menu. The 

parameters in this menu specify 
the external communication 
details. 


>SET 

ES SETUP: SEE MANUAL FOR DETAILS... 

SET #X,#Y - SET ITEM X TO VALUE CORRESPONDING TO Y 
LD 0;SAV 0 LOAD/SAVE SETUP FOR CURRENTLY SELECTED USER 

SYSTEM: #1 USER = 0; [0,1] 

#2 RESET CHAR = $1A 

#3 XON, XOFF = $11,$13 

#4 TRACE MODE =2; [0,1,2,3] (68020 ONLY) 

TERMINAL: #10 BAUD RATE = #14; [2=110,5=300,10=2400,14=9600] 

#11 STOP BITS = 1 [1,2] 

#12 PARITY = 0; [0=NONE,1=EVEN,2=ODD] 

#13 CRT LENGTH = #24 

#14 TRANSPARENT MODE ESCAPE SEQUENCE = $1B,$1B 

COMPUTER: #20 BAUD RATE = #14; [7=1200,12=4800,15=192003 
#21 STOP BITS = 1 
#22 PARITY = 0 

#23 TRANSPARENT MODE ESCAPE SEQUENCE = $1B,$1B 
#24 COMMAND TERMINATOR SEQUENCE = $0D,$00,$00 
#25 UPLOAD RECORD LENGTH = #32; [1 to 127] 

#26 DATA FORMAT = 0; [0=INT,1=MOS,2=MOT,3=SIG,4=TEK,5=XTEK] 
#27 ACKNOWLEDGE CHAR = $06 


( continued ) 
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SET COMMAND (cont.) 


SET <parameter >, <exp> The value of the specified 

parameter is changed to <exp>. 
If you assign an illegal value to a 
variable, an error message is 
displayed, and the value is not 
changed. 

The table below shows the valid 
values for each SET variable. 
All arguments preceeded with a 
H] indicate that the value 
entered must be a 7-bit ASCII 
character. 


Comments 


In the commands that follow, “#” indicates a decimal number. It is not 
required for the numbers 0-9. 


Parameters Description 


Reset Required 


SET #1,#0 User 0 No 

SET #1,#1 User 1 No 

Two users may save and load values to the EEPROM. 
This parameter indicates which user is active when 
executing the SAY and LD commands. 


SET #2,$n Reset Character No 

The reset character will reset the Emulator and the pod 
CPU. The system default is CTRL Z ($1 A). 
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Parameters Description 


Reset Required 


SET #3,$n,$m XON/XOFF Characters No 

XON and XOFF control the screen scrolling. An 
XOFF will stop a scrolling display. XON will resume 
the scrolling. The system defaults are CTRL Q, CTRL 
S ($13, $11). 


SET #4, Trace Mode (68020 only) 

#0 Mode 0 

#1 Mode 1 

#2 Mode 2 

#3 Mode 3 


No 


SET #10,#1 
#2 
#3 
#4 
#5 
#6 
#7 
#8 
#9 
#10 
#11 
#12 
#13 
#14 
#15 


75 baud 

110 baud 

134.5 baud 

150 baud 

300 baud 

600 baud 

1200 baud 

1800 baud 

2000 baud 

2400 baud 

3600 baud 

4800 baud 

7200 baud 

9600 baud (default) 

19200 baud 

The terminal port baud rate 


Yes 


SET #11,#1 
#2 


1 stop bit (default) 

2 stop bits 


The number of stop bits for the terminal port 


Yes 


( continued ) 
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SET COMMAND (cont.) 


Parameters 


SET #12,#0 
#1 
#2 


SET #13,#n 


SET #14,$n,$m 


SET #20,#1 
#2 
#3 
#4 
#5 
#6 
#7 
#8 
#9 
#10 
#11 
#12 
#13 
#14 
#15 


Description 


Reset Required 


No Parity (default) Yes 

Even Parity 
Odd Parity 

The parity for the terminal port 

CRT length (default: 24 lines) No 

The maximum number of lines displayed for 
commands that use paging 

Transparent mode 

Escape sequence No 

When entered from either port, transparent mode is 
terminated. The default sequence is ESC, ESC 
($1B,$1B). 


75 baud Yes 

110 baud 

134.5 baud 

150 baud 

300 baud 

600 baud 

1200 baud 

1800 baud 

2000 baud 

2400 baud 

3600 baud 

4800 baud 

7200 baud 

9600 baud (default) 

19200 baud 

The computer port baud rate 
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Parameters Description 


Reset Required 


SET #21,#1 
#2 


1 stop bit (default) 

2 stop bits 


Yes 


The number of stop bits for the computer port. 


SET #22,#0 No Parity (default) 

#1 Even Parity 
#2 Odd Parity 

Parity for the computer port. 


Yes 


SET #23,$n,$m Transparent Mode 

Escape Sequence No 

When entered from the computer port, transparent 
mode is exited. The default sequence is ESC, ESC 
($1B,$1B). 


SET #24,$n,$m,$o 

Command terminator sequence No 

The default sequence is [return] , null, null (SOD, $00, 

$ 00 ). 


SET #25,#n Upload record length No 

The maximum length for an upload record. (The 
default length is 32 bytes of data.) 


SET #26,#0 
#1 
#2 
#3 
#4 
#5 


Intel (default) 

MOS 

Motorola 

Signetics 

Tektronix 

Extended Tekhex 


No 


( continued ) 
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SET COMMAND (cont.) 


Parameters Description 


Reset Required 


SET #27,$n Acknowledge character No 

The acknowlege character is sent when a valid record is 
received when downloading in computer control. The 
default is $06. 


Comments 


Some SET parameters require the system to be reset, and will prompt for a 
reset character. If you change a parameter that requires a reset, but do not 
enter one, subsequent displays of the SET menu will show the new value 
you have assigned the variable, even though it is not currently in effect. 

If you have changed the SET parameters and wish to use the new values at 
a later date, you can save them in EEPROM by entering a SAY or SAY 0 
command. 

Saved parameters can be loaded automatically at power-up or manually 
after the system is up and running. To load automatically, set the thumb¬ 
wheel switch (see page 3-5) before turning on the Emulator. To load 
manually, enter LD (to load all variables and settings) or enter LD 0 com¬ 
mand (to load just the SET parameters). 

See Serial Communication (page 5-29) for information on communicating 
with a host computer. 
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SWITCH SETTING 


Command Result 

ON 


Displays the ON/OFF menu. 

OFF 


Displays the ON/OFF menu. 

>0N 



ES 

SWITCH 

SETTINGS 

LD/SAV 4 

: LOAD/SAVE SWITCH SETTINGS IN EEPROM 

EXAMPLES 

: >0N 

BTE + CPY + SLO 


>OFF 

FST + PPT 

VALUE 

NAME 

DESCRIPTION 

OFF 

PPT 

TRACE PEEK/POKE CYCLES 

ON 

BTE 

BUS TIMEOUT ENABLE 

OFF 

FTO 

FAST BUS TIMEOUT 

OFF 

DBP 

DISABLE BUS ERRORS ON PEEKS/POKES 

ON 

SLO 

SLOW INTERRUPT 

OFF 

FST 

FAST INTERRUPT 

OFF 

CAS 

CONTINUOUS ADDRESS STROBE WHILE PAUSED 

OFF 

TAD 

TRI-STATE ADDRESS BUS WHILE PAUSED 

OFF 

SPD 

VIEW BUS TIMING INFO INSTEAD OF IPLS 

OFF 

IM 

INTROSPECTIVE MODE 

ON 

ECS 

CONTINUOUS ECS/OCS WHILE PAUSED (68020 ONLY) 

OFF 

CDS 

CACHE DISABLE (68020 ONLY) 

OFF 

> 

CPY 

COPY DATA TO TERMINAL & COMPUTER PORTS 


ON <switch> 


Set the specified switch to the 
ON position. 


( continued ) 
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SWITCH SETTING (cont.) 


OFF <switch> Set the specified switch to the 

OFF position. 


Comments 


Some ON/OFF switches cannot be set during run mode. 

The arguments to the ON and OFF commands are the names of the 
switches themselves. These are: 

BTE Bus timeout enable 

CAS Continuous address strobe while paused 

CDS Cache disable (68020 only) 

CPY Copy data to terminal and computer ports 

DBP Disable bus errors on peeks/pokes 

ECS Continuous ECS/OCS while paused (68020 only) 

FST Fast interrupts 

FTO Fast bus timeout 

IM Introspective mode 

PPT Trace peek/poke cycles 

SLO Slow interrupt 

SPD View bus timing info instead of IPLS 

TAD Tri-state address bus while paused 

You may turn on or off multiple switches by listing them with a 0 between 
their names. 

You can save all of the current switch settings in EEPROM for later use by 
executing a SAV (to save all variables and settings) or SAV 4 (to save just 
switch settings) command (see page 5-25). 
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SWITCH SETTING (contj 


The saved switches can be loaded automatically at power-up or manually 
after the system is up and running. To load automatically, set the thumb¬ 
wheel switch (see page 3-5) before turning on the Emulator. To load 
manually, enter LD (to load all variables and settings) or LD 4 (to load just 
the switch settings) (see page 5-27). 


Examples 


If you want a hard copy of an emulation session, attach a printer to the 
computer port on the back chassis of the Emulator. Turn on the copy 
switch so that all data is copied to both serial ports. 


>0N CPY 
> 
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BUS TIME OUT ENABLE 


Command 


Result 


ON BTE With BTE switch enabled, the 

Emulator generates a bus error 
and breaks emulation if a bus 
cycle is not terminated in a 
reasonable period of time (refer 
to page 5-20). A bus error 
message is displayed on the 
screen. 


OFF BTE 


When BTE is off, the Emulator 
does not terminate a bus cycle. 

Default: OFF 


Comments 


When a bus error is detected with BTE either ON or OFF, the entire target 
system stack of registers is saved. These registers are saved in the 
Emulator under specific names and may be examined and/or modified. 
(See page 5-70). BTE is always enabled for peeks/pokes while paused, 
regardless of switch setting. 
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CONTINUOUS ADDRESS STROBE 


Command 


Result 


ON CAS If CAS is ON, the address strobe 

continues to be active in the tar¬ 
get system while paused. 

OFF CAS If CAS is OFF, the address 

strobe is active only during run 
mode. 

Default: OFF 


Comments 


Use this software switch to allow the address strobe to go to the target sys¬ 
tem while the Emulator is not in run mode. 
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CACHE DISABLE (68020) 


Command 


Result 


ON CDS When the cache disable is ON, 

the CDIS pin in the emulator is 
asserted. The microprocessor 
will not use its cache memory. 
This is necessary if the trace 
disassembler is going to be used. 

OFF CDS When CDS is OFF, the CDIS 

signal in the target system is 
used. Cache memory will 
operate normally with internal 
cache cycles replacing some of 
the external bus cycles during 
small loops. 

Default: OFF 


Comments 


You may want to enable the CDS switch if you are disassembling trace 
memory (see page 5-103). 
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COPY DATA TO BOTH PORTS 


Command 


Result 


ON CPY 


OFF CPY 


Send all data to both the termi¬ 
nal and computer ports. Data 
sent to the controlling port is 
echoed to the other port (non¬ 
controlling port). 

Only send data from the Emula¬ 
tor to the controlling port. 

Default: OFF 


Comments 


This provides a way to make a hard copy of emulation data. It is also use¬ 
ful for monitoring computer control commands. 

See Serial Communications, page 5-29, for more information on the ter¬ 
minal and computer ports. 
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DISABLE BUS ERRORS ON PEEKS/POKES 


Command 


Result 


ON DBF When DBP is ON, the bus error 

signals coming from a target 
system are ignored by the Emu¬ 
lator during peeks/pokes. 
However, the Emulator will still 
generate a bus error when one is 
detected by the Emulator’s built 
in watchdog circuit. 

OFF DBP When DBP is off, target system 

bus errors are detected and will 
display on your console screen. 

Default: OFF 


Comments 


Use this software switch to disable bus errors generated by the target if 
using overlay memory mapped to a target area that will generate bus errors 
when accessed. 
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EXTERNAL CYCLE START (68020) 


Command 


Result 


ON ECS When ECS is ON, the Emulator 

sends both the external cycle 
start (ECS) and the operand 
cycle start (OCS) signals to the 
target system while in pause 
mode. 

OFF ECS When ECS is OFF, the Emulator 

does not send the external cycle 
start (ECS) or the operand cycle 
start (OCS) signal to the target 
system while in pause mode. 

Default: ON 


Comments 


This software switch setting is operable only on the 68020 microprocessor. 
The ECS and OCS signals will always operate during run mode. 
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INTERRUPT ENABLE 


Command 


Result 


ON SLO When SLO (slow interrupt 

enable) is ON, interrupts will 
not be enabled immediately 
upon going into run mode. A 
delay of approximately 160 
clock cycles will elapse before 
interrupts are enabled. 

Default: ON 

ON FST When FST (fast interrupt 

enable) is ON, interrupts will be 
enabled the moment the 
Emulator begins executing the 
target system program. 

Default: OFF 


Comments 

The FST switch will take precedence over the SLO switch when both are 
in the ON switch setting. 
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INTERRUPT ENABLE (cont.) 


Switch setting matrix: 


SLO 

FST 

RESULTS 

ON 

ON 

Interrupts immediately enabled 

ON 

OFF 

Interrupts delayed 

OFF 

ON 

Interrupts immediately enabled 

OFF 

OFF 

Interrupts generated by the 

target system will be inhibited from reaching the 
Emulator. 
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FAST TIME OUT 


Command 


Result 


ON FTO When FTO is on, BTE requires 

2240 clock cycles. 

OFF FTO When FTO is off, BTE requires 

35,840 clock cycles. 

Default: OFF 


Comments 


FTO should be set appropriately for the target system’s bus error timeout. 
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INTROSPECTIVE MODE 


Command 


Result 


ON IM When IM is ON, the Emulator 

recognizes its own internal 
memory space as a target sys¬ 
tem. This allows the DNL 
command to download to this 
internal memory space just as it 
would a target system. 

OFF IM The Emulator recognizes the 

pod assembly and target micro¬ 
processor connected to its 
emulation board as the target 
system. 

Default: OFF 

Comments 

This command is valid only in pause mode. 
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PEEK POKE TRACE 


Command 

Result 

ON PPT 

This will cause the system while 
in the pause mode to trace all 
target reads (peeks), and writes 
(pokes) cycles to the target 
system. 

OFF PPT 

In this software switch position 
trace memory will only trace 
those memory cycles in the 
target system. Peeks and pokes, 
while in the pause emulation 
mode, are not traced. 


Default: OFF 

Examples 


To trace peeks and pokes to a particular memory location: 

ON PPT 

AC1 = 5550 

CES; WHEN AC1 THEN TRC 

ITR 

SF 1, 5000 to 5FFF 


All peeks, pokes and memory cycles at the specified memory location will 
be traced by trace memory. To display what has happened at this location 
(5550) during the memory diagnostics, use the DRT command. 
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VIEW BUS SPEED INFORMATION 


Command 


Result 


ON SPD When SPD is ON, the IPL col¬ 

umn will display a number that 
relates to the access time of 
devices on the target system bus. 

OFF SPD When SPD is OFF, the state of 

the interrupt lines will be 
displayed. 

Default: OFF 


Comments 


Use this software switch setting to view bus timing information instead of 
the state of the interrupt lines (IPL) from the target system. 

The DRT command contains a column labeled IPL that displays the state of 
the interrupt lines from the target system. 

If the SPD switch is ON, this column is labeled SPD. 

If one access displays a 4 and another a 5, the later bus cycle took one more 
clock cycle to complete than the former. Access times greater than or 
equal to 10 cycles display as 0. 

The IPL/SPD column is not displayed when in trace mode 2 (68020 only). 
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TRI-STATE ADDRESS BUS 


Command 


Result 


ON TAD When TAD is ON, the Emulator 

address bus is tri-stated while 
paused. This will tri-state the 
address bus any time the 
Emulator is not emulating and 
doing peeks and pokes. 

OFF TAD When TAD is OFF, addresses 

generated during pause mode 
are output by the Emulator 
address bus to the target system. 

Default: OFF 
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SAVE SYSTEM VARIABLES IN EEPROM 


Command 


Result 


SAY 


Copy all system variables from 
Emulator memory into 


EEPROM. 


SAY <category> 


Save one of the six categories of 
variables from Emulator RAM 
to EEPROM. 


Comments 


This command is valid only in pause mode. 

A SAY operation may take up to two minutes. 

DO NOT INTERRUPT THE PROCESS! 

Values saved to EEPROM continue to be valid within the Emulator. 

There is room in EEPROM to save the system variables for two different 
users. The user is determined by a parameter in the SET menu. When you 
execute a SAY, the variables are saved to the user partition currently 
defined in the SET menu. 


( continued ) 
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SAVE SYSTEM VARIABLES IN EEPROM (cont.) 


This chart shows the categories of information that can be saved in 
EEPROM and the corresponding page numbers to find more information. 


0 - 

SET menu 

5*3 

1 - 

Contents of Emulator registers 

5-71 

2 - 

Event Monitor System 

WHEN/THEN Statements 

7-1, 8-1 

3 - 

Overlay map 

5-55 

4 - 

Software switch settings 

5-9 

5 - 

Macros 

5-117 


Variables are loaded from EEPROM back to the Emulator using the LD 
command. 

When you first receive your Emulator, you should execute a SAV com¬ 
mand with no parameter. This initializes EEPROM, so that subsequent LD 
commands will work properly with the 68000 series Emulator board and 
pod. 


Examples 


>SAV 1 


The current values of all the Emulator registers are saved in EEPROM. 
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LOAD SYSTEM VARIABLES FROM EEPROM 


Command 


Result 


LD Copy all system variables stored 

in EEPROM into Emulator 
memory. 

LD <category> Copy the variables from one of 

the six categories in the 
EEPROM to the Emulator 
RAM. 


Comments 


This command valid only in pause mode. 

Executing a LD command reads system variables from the EEPROM and 
copies them to into internal RAM. The EEPROM retains those original 
variables until replaced by a SAV command. 

There is room in the EEPROM to load the system variables for two 
different users. The user is determined by a parameter in the SET menu. 

You may load the following variable categories from EEPROM: 


0 - SET menu 

1 - Contents of Emulator registers 

2 - Event Monitor System WHEN/THEN statements 

3 - Overlay map 

4 - Software switch settings 

5 - Macros 


( continued ) 
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LOAD SYSTEM VARIABLES FROM EEPROM (cont.) 


Examples 


>LD 3 


The overlay memory map in the EEPROM is copied into internal RAM. 
Use the DM command to verify the new map. 
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Section 5: System Commands 


Serial Communications 

The ESI800 can communicate through both DB-25 connectors on the 
chassis rear panel using standard RS232C serial protocol. The ports can be 
independently configured for baud rate, data length, and number of stop 
bits. 

USING A HOST COMPUTER 

The most common development configuration is with a terminal connected 
to the terminal port of the ESI800 and a host development system con¬ 
nected to the computer port. The ESI800 provides a transparent mode that 
essentially connects your terminal to the computer. The ESI800 also has a 
special download command to load modules from the host system. 

In configurations where the ESI800 is connected directly to a host com¬ 
puter, there are a few details that need to be considered. 

DATA BUFFERING AND BAUD RATE 

When downloading from a computer, the ESI 800 buffers all the data bytes 
until the end of record. If the checksum is correct, the data are then 
loaded into target memory. During this load time, the host computer may 
start sending the next data record. The serial data buffer in the ESI800 is 
64 bytes deep. When the sixth character is placed in the buffer, an XOFF 
character is sent to the host computer. This means that the host computer 
must transmit no more than 58 characters after the XOFF. Some multi¬ 
tasking development systems may not be capable of quickly stopping char¬ 
acter transmission. For these systems, it may be advisable to lower the 
computer port and host computer’s baud rates. 

XON and XOFF characters can be used to control either output port on the 
ESI800. These characters are user definable. The problem described in 
the above paragraph can happen in the reverse direction. If the ESI 800 is 
uploading data to the host, it may be able to overrun the host’s ability to 
receive characters. While lowering baud rates may help, there are probably 
commands available on your host to solve the problem. You should also 
make sure that the host does not echo characters sent to it while uploading 
data. If the characters are echoed, the ESI800 will quickly send an XOFF 
to the host while continuing to send normal upload characters. The host 
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system will then probably send an XOFF to the ESI800 because the host’s 
buffers are full. The result of this situation is that both systems will lock 
up waiting for the other to send an XON. See your system administrator or 
call Applied Microsystems Corporation Customer Service at 
1-800-426-3925 for help. 

COMMUNICATION WITH THE HOST COMPUTER 

While in transparent mode, the ESI800 passes characters between the com¬ 
puter and terminal ports. There is a user definable two-character escape 
sequence to exit transparent mode. If the first character of the escape 
sequence arrives at either port, the ESI800 “holds” it until it receives 
another character from the same port. If the second character matches the 
second character of the escape sequence, transparent mode is terminated. 
If the second character is not part of the escape sequence, then both the 
character being “held” and this second character are sent to the proper 
port. See page 5-3 for setting the escape character sequence. 

While in transparent mode, the only characters that are meaningful to the 
ESI800 are XON, XOFF, the first character of the escape sequence, and 
the reset character. The reset character may be sent from the host as part 
of a command sequence to the terminal. This is common during edit ses¬ 
sions and depends on the command set of your terminal. You should 
define the reset character to be a character that will not normally be used 
by the host system. 

PORT DEPENDENT COMMANDS 

Most commands are symmetric with respect to the controlling port and 
appear to respond in the same manner if entered from either the computer 
port or the terminal port. The controlling port is determined at power-up 
by the setting of the rotary switch on the controller board (see 3-5). After 
power-up, the commands CCT and TCT switch control from one port to 
the other. TCT entered to the terminal port acts like a null command as 
does CCT entered at the computer port. 

Entering transparent mode from either port causes both ports to be “con¬ 
nected” to each other. If transparent mode is terminated from either port, 
control returns to the port that initiated the transparent mode (TRA) 
command. 
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Section 5: System Commands 


DOWNLOAD FROM TERMINAL PORT 

When the ESI800 receives a download command (DNL), it always expects 
data records to arrive at the computer port. If the download command is 
entered from the terminal port, the ESI800 automatically enters trans¬ 
parent mode to allow you to send commands to your host system. You 
normally enter a command that causes your host system to copy the for¬ 
matted object file to your terminal (see page 5-7 for object file formats). 
The proper procedure is to enter the command to your host system but not 
terminate it (i.e., do not press the IreturnI key). Instead, enter the two- 
character transparent mode escape sequence. When transparent mode ter¬ 
minates, control returns to the download process. The download routine 
then sends the user definable command terminator sequence to your host 
system (see page 5-3). Your host system responds by sending the data 
records from your formatted object file. Any characters sent by the com¬ 
puter are echoed to the terminal port. All valid data records are copied 
into internal buffers and the data are written into target memory. When 
the End of File (EOF) record is received, the download process terminates 
and a normal ESL prompt is displayed. 

If an error occurs (checksum or read-after-write) during the download, 
the process terminates with an error and a new prompt is displayed. No 
special characters are sent to the host, however, so it is likely that the next 
time you enter transparent mode, the host will send the remainder of the 
download data records. 

DOWNLOAD FROM COMPUTER PORT 

If the download command is entered from the computer port, the process is 
different. In this case, the ESI800 does not enter transparent mode. The 
DNL command can be immediately followed by data records. Each data 
record is acknowledged with an ACK (6) character if its checksum is cor¬ 
rect and correctly written into target memory (verified with read-after¬ 
write cycles). The EOF record is also acknowledged if valid. If an error 
occurs during a download, the first character sent back to the host will be 
the BEL (7) code. Programs written on your host system can use these two 
characters to handshake the data records in an automatic download 
routine. 
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TRANSPARENT MODE 


Command 


Result 


TRA 


The system enters transparent 
mode. 


ESC ESC Port control is returned to the 

previous settings. Note that this 
escape sequence can be changed 
using the SET command (page 
5-3). 


Comments 


Transparent mode can be entered while in terminal (TCT) or computer 
control (CCT) mode. 

In transparent mode the Emulator acts only as an interface between the 
two serial ports. The Emulator can buffer up to 64 characters for each port 
and can operate each port at independent baud rates. 

Obviously, there must be devices connected both to the terminal port (such 
as a terminal) and the computer port (host system, line printer) for this 
command to have any meaning. 

Transparent mode is used to communicate with a host computer, or any 
other peripheral you want to attach to a serial port. 

Refer also to Serial Communications (page 5-29). 
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TRANSPARENT MODE (cont.) 


Examples 

>TRA 

Data entered at either port is transmitted directly to the other port. 
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TERMINAL PORT CONTROL 


Command 


Result 


TCT 


The terminal port becomes the 
controlling port. 


Comments 


This command, along with the CCT command, allows control to be 
switched between the two serial ports without powering down the ESI800 
Emulator. 

Any output generated by a command is directed to the controlling port. 
The copy switch directs output to both serial ports. 

This command is essentially a null command when entered from the 
terminal port. 

For port selection on power-up refer to page 3-5. 
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COMPUTER PORT CONTROL 


Command 


Result 


CCT 


The computer port becomes the 
controlling port. 


Comments 


This command, along with the TCT command allows control to be 
switched between the two serial ports without powering down the ESI800 
Emulator. 

Any output generated by a command is directed to the controlling port. 
The copy switch directs output to both serial ports. 

This command is essentially a null command when entered from the 
computer port. 

If there is a host attached to the computer port and you type a CCT from a 
terminal connected to the terminal port, the host system takes control of 
the Emulator. The host system must be able to handle incoming data at 
high rates. Both hardware and software handshakes are supported (see 
page 3-14). 

The upload and download operations always send/receive data from the 
computer port regardless of which port is the designated controller. 
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COMPUTER PORT CONTROL (cont.) 


If you execute CCT in error with no terminal or host system connected to 
the computer port: 

■ Move the terminal cable to the computer port, enter the 
TCT command and return the cable to the terminal port. 

In most cases this process returns control to the terminal. If 
not: 

■ Turn the Emulator off and then on. 

This command can be executed from the computer port. For port selection 
on power-up refer to page 3-5. 
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DOWNLOAD OPERATIONS 


Command 


Result 


DNL DNL readies the Emulator to 

receive data. If in terminal con¬ 
trol mode, the Emulator enters a 
transparent mode automatically, 
allowing direct communication 
with the host system. Other host 
system commands may be 
executed prior to the download 
operation. 


Comments 


You can choose the destination of the downloaded file: 

■ Target memory 

■ Overlay memory 

If the downloaded data is going to overlay memory, verify that the overlay 
is mapped in the appropriate address range. Make sure that the start 
address of the file is the address to which you expect to download. 

Verify also that the data format of the host system file matches that being 
used by the Emulator. Refer to SET menu set parameter #26 for verifica¬ 
tion of Emulator format. Use transparent mode (TRA) to verify host 
system format and the address in the file. (See page 5-32.) 

You can download files with either the computer port or the terminal port 
in control. That is, the downloading of files can be initiated and controlled 
either by the user or by a host system. There are some differences in 
procedure depending on which port is in control of the downloading 
process. 


( continued ) 


5-37 



DOWNLOAD OPERATIONS (cont.) 


DOWNLOADING UNDER TERMINAL PORT CONTROL 

After typing DNL, the system automatically enters transparent mode, 
allowing communication with the host system. When you are ready to 
download the file, enter a command that causes the host system to display a 
file to the terminal, but in place of a [return], enter the transparent mode 
escape sequence (see page 5-32). 

The Emulator is now ready to read the data records the host system will be 
sending. Data records are displayed as they are received by the Emulator. 
Checksums are verified and if a checksum error occurs, the download is 
aborted with an error message. The data in the erroneous record will not 
have been written to memory. 

Each data byte is verified with a “read after write” cycle. If an error is 
detected, the download is aborted. 

RETURN CONTROL TO EMULATOR 

Once the download command (DNL) is entered, control is returned to the 
Emulator in one of three ways: 

1. An end of file record is received. If an end of file record 
is not recognized by the Emulator, control will not be 
returned to the Emulator terminal port. This can be 
caused by: 

■ Using a [return] instead of the proper 
escape sequence to terminate the 
command line to the host computer. 

■ Selecting the incorrect data format. 

2. An Emulator reset is executed (factory default is 
[CTRL| [z]). 

3. An error is detected. 
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DOWNLOAD OPERATIONS (cont.) 


DOWNLOADING UNDER COMPUTER PORT CONTROL 

To download while in computer control with a host computer attached, the 
host computer should send: 


>DNL 


After the host sends the download command, the Emulator waits for data 
at the computer port. The host computer should then send the download¬ 
able records followed by an end of file record. After the end of file 
record, the system prompt ([>]) is sent to the computer port. 

An acknowledge character (factory default is ASCII ACK $06) will be sent 
to the computer port after storing a data record, when in computer control. 
No acknowledgments are sent when in terminal control. 

There are some differences between computer port control and terminal 
port control during the downloading process. Under computer port 
control: 

■ All good records are acknowledged with an |ack $ 06 | . 

■ All error messages from bad records are received on the 
computer port; therefore the host program that is 
controlling the Emulator will need to be able to interpret 
error messages. 

■ Records are not echoed. 

SYMBOLIC DOWNLOAD 

The download command accepts symbolic definition records as well as 
data records when the symbolic debug option is used and the Emulator 
download format variable is set to 5 (Extended Tekhex). (See SET 
parameter #26, page 5-7.) 

Serial data can be verified with memory constants using the VFY 
command. 
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DOWNLOAD OPERATIONS (cont.) 


Errors 


CHECKSUM ERROR IN THE DATA RECORD 

The download process is aborted because the checksum sent with a record 
file is not the same as the checksum calculated by the Emulator. 

READ AFTER WRITE VERIFY ERROR 

Every byte in a data record is verified after it is stored. This error indi¬ 
cates that the data in memory do not match the data that were stored. 


Problem 


What to Check 


Emulator does not return a prompt 
after file has been sent. 


Read-after-write verify error. 


1. Serial data format - SET 
menu. 

2. No end of file (EOF) 
record. 

3. You entered a |return| 
instead of the 
transparent mode escape 
sequence after entering 
the host copy command. 


1. Target hardware 
problem. 

2. Overlay memory not 
mapped in download 
range. Address is 
indicated by misverify 
message. 
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DOWNLOAD OPERATIONS (cont.) 


Checksum error. 


1. Improperly formatted 
record sent by host. 

2. Noisy serial data lines. 

3. Host computer is not 
responding to 
XON/XOFF protocol. 


Display of data does not 
commence after entering 
transparent mode escape 
sequence. 


1. Host not responding to 
user defined command 
terminator sequence - 
SET menu. 


If the Emulator does not return a prompt, you will need to reset the system 
(default is [ctrlI \z\ ) in order to enter any other Emulator commands. 


If the host computer is not responding to the XON/XOFF protocol fast 
enough, you may need to lower the baud rate on the computer port and the 
host computer. 
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VERIFY SERIAL DATA 


Command 


Result 


VFY Verify serial data with data in 

memory. If the data in memory 
do not match the incoming 
serial data, this message is 
displayed: 

[ADDRESS = XX NOT YY| 

“Address” is the address where 
the data mismatch occurred. 
“XX” denotes the actual data 
present at that location. “YY” 
is the serial data just sent. 


Comments 


This command is similar to the download command but no data is written 
to memory, and the serial data is not displayed on the screen. The serial 
data is compared to the data in target or overlay memory. Mismatches are 
displayed. 

Use this command if you suspect a file you downloaded was corrupted. If 
downloaded data is being corrupted by your program, you can detect it by 
mapping overlay as RO (read only) (see page 5-55). 

This command is also useful for determining differences between object 
files. Follow instructions for downloading a file on page 5-37. 
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UPLOAD SERIAL DATA 


Command 


Result 


UPL <range> 


The Emulator formats and sends 
data to the computer port. 


Comments 


Data is transferred from the Emulator to a host system or other peripheral 
interfaced to the Emulator computer port. 

If uploading to a file on a host system, transparent mode should be entered 
first in order to open a file to store the uploaded data records. (Refer to 
your host system instructions on ASCII files.) 

Example 

UNIX CAT >Filename 
VMS TYPE >Filename 

(Create or EDT are also acceptable) 

CPM PIP A:Filename = RDR: 

After this is done, enter the transparent mode escape sequence, and the 
upload command. 

After all data has been uploaded and the Emulator prompt is returned, 
enter transparent mode and close the file by entering the appropriate 
control character. 

Remember to close the file before trying to view it. 
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UPLOAD SERIAL DATA (cont.) 


If your host system does not respond to XON/XOFF protocol, it may be 
necessary to lower the communicating port’s baud rates so that the host’s 
input buffer is not overrun. 

Upload performs no data verification. 

A file may be uploaded to a printer, PROM programmer or other periph¬ 
eral instead of a host. In this case, there is no need to enter transparent 
mode before uploading. Just be sure the peripheral is ready to receive 
data. 

Refer also to Serial Communications, page 5-29. 
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UPLOAD SYMBOLS 


Command 


Result 


UPS All currently defined symbols 

and sections are sent to the 
computer port in Extended 
Tekhex format. 


Comments 


Extended Tekhex restricts the number and range of characters that can be 
used for symbol names. When formating symbols for upload, the Emulator 
truncates symbol names to 16 characters and substitutes [§ for characters 
not allowed by Tekhex. 

Extended Tekhex serial data format should be set before uploading 
symbols. (SET #26,5) 

If uploading to a file on a host system, transparent mode should be entered 
first in order to open a file to store the uploaded data records. (Refer to 
your host system instructions on ASCII files.) 

Example 

UNIX CAT >Filename 
VMS TYPE >Filename 

(Create or EDT are also acceptable) 

CPM PIP A:Filename = RDR: 

After this is done, key in the transparent escape sequence, and begin the 
uploading. 


( continued ) 
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UPLOAD SYMBOLS (cant.) 


After all data has been uploaded and the Emulator prompt is returned, 
enter transparent mode and close the file by entering the appropriate 
control character. 

Remember to close the file before trying to view it. 

Refer also to Serial Communications, page 5-29, and Symbols, page 5-126. 


5-46 



COMMUNICATION WITH TARGET PROGRAMS 


Command 


Result 


COM <address> Establishes communication with 

target program through two 
byte pseudo-port at the 
specified address. 

Exit COM mode by entering the 
two character transparent mode 
escape sequence (see SET, page 
5-3). 


Comments 


This command is only useful during run mode. It affects real time 
operation and requires special target code. COM mode uses two bytes at 
the specified address. The byte at <address> is used for characters sent 
from the target to the controlling port. The byte at <address> + 1 is used 
for characters being sent to the target program. This command makes use 
of 7 bit ASCII characters, with the eighth bit of each byte used for 
handshaking. 

To transmit a character to the ESI800, the target program first checks the 
most significant bit (MSB) of the byte at <address>. If this bit is set (1), 
the Emulator has not yet collected the previous character. If the bit is 
cleared, the target program sets the MSB of the character to be transmitted 
and places the result in the byte at <address >. 

To receive a character from the Emulator, the target examines the byte at 
<address> + 1. If the MSB of this byte is cleared, the Emulator has not yet 
transmitted a new character. If the MSB is set, the character is new. If the 
controlling port of the ESI800 is a terminal, the target program should 


( continued ) 
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COMMUNICATION WITH TARGET PROGRAMS (cont.) 


echo the character back by immediately copying the character into the 
byte at <address> with the MSB still set. The target then program masks 
the MSB off and stores the result back at <address> + 1. This prevents the 
target program from re-reading the same character. 

The COM routine does not check the byte at <address> + 1 to see if the 
target program has received it. Generally, the target program will be sub¬ 
stantially faster than the COM routine and will always receive one 
character before the COM routine can transmit the next. 

The COM mode essentially establishes a transparent mode between the 
running target program and the controlling port of the ESI800. Whenever 
the ESI800 reads target memory during run mode, it actually stops emula¬ 
tion for about 100 microseconds. To avoid significant impact on real time 
operation, the COM routine examines the byte at <address> only once 
every 0.5 second. When the COM routine discovers a new byte from the 
target program, it reads the byte and clears the location. The byte is then 
sent to the controlling port of the ESI800. The COM routine then 
immediately returns to examine the byte at <address>. A target output 
routine has approximately 100 microseconds to place another character in 
the output location. If this 100 microsecond window is missed, the display 
of the subsequent character will be delayed for 0.5 second. 

The following flow diagram summarizes the COM process. 
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COMMUNICATION WITH TARGET PROGRAMS (coni.) 


Examples 


One good example of using the COM command is to simulate a serial I/O 
port when debugging code before target hardware is available. The target 
program is downloaded into overlay memory and emulation is entered by 
using the RUN command. The address supplied to the COM command is 
that of a simulated RS232 data port. Data entered at the terminal is passed 
to the target program and data output by the program appears on the 
terminal. 


>MAP 0 TO -1 

/* Map all available RAM */ 

>DNL 


%cat serial.driver 

/* Download program to overlay */ 

(enter transparent mode 

escape sequence) 

>RNV 

/* Run program */ 

R>COM 'serial_port 

/* Use serial data port as COM addr */ 


A note of caution. If a breakpoint or an error is encountered while run¬ 
ning the COM command, the system will appear to hang up. This is 
because Emulation has been broken, and the target program that receives 
and transmits characters is no longer running. Entering the transparent 
mode escape sequence will terminate COM mode and cause the break or 
error message to be displayed. 
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DISPLAY CHARACTER STRING 


Command 


Result 


DIA <address> Read and display characters 

from target memory starting at 
the specified address. The DIA 
routine terminates when it reads 
$00 from target memory. 

Affects real time operation 
when entered in run mode. See 
page 6-1. 


Comments 


DIA is commonly used for test purposes in target systems that have no 
human readable I/O channels. 

When a test routine detects a problem, it can load a register with the 
address of a null terminated error message. The routine then jumps to an 
address that causes the Emulator to break emulation. The DIA command 
can then be used to display the error message. 

DIA can also be used to check the contents of any null terminated string in 
memory. 


/ continued ) 
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DISPLAY CHARACTER STRING (cont.) 


Examples 


>BYM 

>M 120 
$000120 $00 

>48,65,6C,6C f 6F,0 

Make sure we're in byte mode. 

Enter Memory mode at address 120 

$000126 $00 

>DIA 120 

Hel lo 

> 

>X 

Enter a null terminated string and exit 
Display string starting at 120 


This example sets a breakpoint in your target error routine. When the 
breakpoint occurs, a message pointed at by the DO register is displayed. If 
the D1 register is zero, the process stops. Otherwise, the ESI800 
immediately begins emulation and waits for another breakpoint and 
message. 


>AC1 = 'Error_stop 

>WHE AC1 THE BRK 

>* RBK;WAI;DIA D0;TST = D1 
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Section 5: System Commands 


Overlay Memory 

Overlay memory can be used to debug target hardware and software. It 
can be used to create and verify programs before hardware is available, 
determine whether your program is making illegal accesses, and patch 
target PROM code quickly and easily. 

Overlay memory is available in memory ranges from 32K to 512K. See 
your Applied Microsystems Corporation sales representative for 
incremental options. 

Overlay can be mapped in segments as small as 2K bytes. Each segment 
can be assigned one of four attributes; target, read/write, read-only or 
illegal. If memory is mapped, it means that you have assigned at least one 
segment of overlay as read/write, read-only or illegal memory. Unmapped 
memory is assigned the target attribute. Memory mapped as target or 
illegal does not use up overlay memory. 

When a segment of memory is mapped, program accesses in that memory 
range are directed to the overlay instead of the target. The overlay can be 
further qualified by the overlay enable register (OVE). This register 
indicates whether code, data or all accesses in a mapped memory range 
should be directed to the overlay memory. 

Overlay memory accesses occur in real time, no wait states are added by 
the Emulator. 
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DISPLAY MEMORY MAP 


Command 


Result 


DM 


Display the memory map 
currently in effect. 


Comments 


This command is valid only in pause mode. 


Examples 


Default map at power up (68000/08/10): 


>DM 

MEMORY MAP: 

OVERLAY ENABLED FOR (OVE=) UD+UP+SD+SP, SPEED (OVS)=0 
MAP $000000 TO $FFFFFF:TGT 


Default map at power up (68020): 


>DM 

MEMORY MAP: 

OVERLAY ENABLED FOR <OVE=) UD+UP+SD+SP, SPEED (OVS)=1 
MAP $00000000 TO SFFFFFFFF:TGT 
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SET MEMORY MAP 


Command 


Result 


MAP <range> 


MAP <value> 


MAP <range><attribute> 


MAP < v aluex attribute > 


The specified range is mapped 
and assigned the default 
attribute type, RW. 

A 2K byte block is mapped 
surrounding the specified value. 
The block is assigned the 
default attribute type, RW. 

The specified range is mapped 
and assigned the specified 
attribute type. 

A 2K byte block is mapped 
surrounding the specified value. 
The block is assigned the 
specified attribute. 


Attributes 


RW Memory mapped with this attribute will respond like 

normal overlay memory. Overlay memory is high speed 
and may actually run faster than target system memory 
if that memory normally asserts “wait states.” 

RW is the most common attribute and is therefore the 
default. MAP commands that do not specify an 
attribute will define RW partitions. 


( continued ) 
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SET MEMORY MAP (cont.) 


RO Memory mapped as RO acts like read only memory to 

your target program. If your program attempts to write 
to this memory, the ESI800 will abort run mode and 
display MEMORY WRITE VIOLATION. The contents 
of RO overlay cannot be altered by a running target 
program. You can always modify memory mapped as 
RO (in pause mode) even though your target program 
(run mode) cannot. 

The same comments about speed given in the paragraph 
on RW, apply to memory mapped as RO. 

ILG Memory mapped as illegal can be used to mark address 

ranges that should not be accessed by your target 
program. Any access to an address range mapped as 
ILG will cause the ESI800 to abort run mode and 
display MEMORY ACCESS VIOLATION. Memory 
mapped as ILG does not use up available overlay 
memory. 

TGT Accesses in address ranges mapped with this attribute 
are ignored by the ESI800. Memory that is not 
explicitly mapped is defaulted to TGT. 


Comments 


Overlay memory is mapped in segments of 2K bytes. If you specify an 
address or a range to be mapped as RW or RO, the mapping outline will 
allocate the minimum number of 2K segments that will completely 
enclosed the address(es) of interest (see overlay memory page 5-63). 

There is a distinction between the overlay map and overlay memory. If 
your system has any overlay memory installed (it is an option), you will 
have a complete overlay map and some limited amount of overlay memory. 
The overlay map covers the entire address space (24 bits). The overlay 
map is used to logically place segments of overlay memory anywhere 
throughout the address space. 
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SET MEMORY MAP (cont.) 


You can save and restore the contents of the overlay map by using the 
EEPROM LD/SAY commands (see pages 5-27 and 5-25). You cannot 
save the contents of overlay memory in EEPROM. 

MAPPING THE 68020 

Two issues need to be considered when using overlay memory with the 
68020 microprocessor. The first issue concerns addressing. The second 
issue deals with wait states. 

ADDRESSING 

The overlay memory in the ESI800 Emulator is limited to 24 address bits 
even though the 68020 microprocessor uses 32 address bits. 

This limits the acceptable mapable range to 16 megabytes. Overlay 
memory may be mapped anywhere in the four gigabyte addressable area of 
the 68020 in 2K increments, provided the mapped area is within a 16 
megabyte window. If an attempt is made to map overlay memory outside 
of the 16 megabyte window (called a segment) the following error will 
appear: 


ATTEMPT TO CHANGE CURRENT OVERLAY SEGMENT (USE CLM FIRST) 


The CLM (clear memory map) command must be issued prior to mapping 
outside the previously specified address range. (See page 5-62). 

When mapping memory for the 68020 the most significant address byte 
must be the same for every 2K byte segment mapped (except for memory 
mapped TGT). 


MAP $1F000000 TO $1F0007FF :RLJ 
MAP $1F100000 TO SIF101FFF :ILG 
MAP $1F200000 TO SIF2007FF :RO 


( continued ) 
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SET MEMORY MAP (cont.) 


WAIT STATES: 

The minimum amount of wait states for the overlay memory is 1. The OVS 
(overlay speed) will automatically default to 1. However, if the target 
systems clock speed is 8 megahertz, 0 wait states will be utilized. If a 
slower speed is required to match slower hardware in the target system, 
type in “OVS=X” where X is 1 through 7. If the OYS value is set to any 
other value, the following error message will occur: 


ILLEGAL OVS VALUE. . .(NOT IN 1-7) 


The reason wait states may be inserted is because the 68020 uses a 25 
percent shorter bus cycle. 

The overlay memory is treated by the 68020 as a 16 bit port. This could 
increase execution time if overlaying a 32 bit bus. 

The addresses in the Emulator for the overlay memory are treated as 
segmented addresses. This is due to the internal 24 bit bus not being large 
enough for the 68020’s architecture. Therefore, 8 extra bits are being 
stored on the pod and appear to the Emulator as a segment for internal 
purposes. However, all accesses to the target area are 32 bit. When 
accessing target memory, typically, the Emulator will not insert any wait 
states. If the target is running over 8 megahertz, and the target area that is 
being accessed is in the same segment as an area of overlay memory that is 
mapped, one wait state may be inserted. 


Examples 


If 0 to 7FF is mapped as RW, and an access to any area of target memory 
that is in the bottom 16 megabyte range (800 to FFFFFF) occurs, a wait 
state may be inserted. 

Again, the reason we may insert a wait state is due to the 68020 bus cycles 
being executed considerably faster than the 68010. Due to the segmented 
logic being located in the pod, the Emulator will know relatively quickly 
that an overlay memory access is going to be made. All we need to 
complete the cycle is to have the ~OME signal come back. This indicates 
the address has been set up and the memory is ready. Then, DSACK will 
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SET MEMORY MAP (cont.) 


be required to terminate the cycle. If OME is received in time, a wait 
state will not be inserted. If the access is in the target area, we will not rely 
on the OME signal unless there is a “match” in the segment logic early in 
the bus cycle. 

The segmented address only affects the overlay memory operation. 

The following command sequence might reflect a common 68000/08/10 
mapping. 


Command 

Comments 

>CLM 

Clear map to all :TGT 

>MAP 'ram-start LEN 2000 

Map some RAM to work with 

>MAP 1 rom-start LEN 4000:RO 

Map ROM 

>MAP $4000 to $DFFF:ILG 

No accesses expected in this range 

>DM 

Display map 

MEMORY MAP: 


OVERLAY ENABLED FOR <OVE=) UD+UP+SD+SP, SPEED (OVS)=0 

MAP $000000 TO $003FFF :RW 

MAP $004000 TO $00DFFF :ILG 

MAP $00E00O TO $00FFFF :RW 

MAP $010000 TO $FFFFFF :TGT 



( continued ) 
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SET MEMORY MAP (cont.) 


The following command sequence might reflect a common 68020 mapping. 


Command 

Comments 

>CLM 

Clear map to all :TGT 

>MAP 'ram-start LEN 2000 

Map some RAM to work with 

>MAP 'rom-start LEN 4000:RO 

Map ROM 

>MAP $4000 to SDFFF:ILG 

No accesses expected in this range 

>DM 

Display map 


MEMORY MAP: 

OVERLAY ENABLED FOR (OVE=) UD+UP+SD+SP, SPEED (0VS)=1 

MAP $00000000 TO $00003FFF :RW 

MAP $00004000 TO $0000DFFF :I LG 

MAP $0000E000 TO $0000FFFF :RW 

MAP $00010000 TO $FFFFFFFF :TGT 


Since the contents of overlay memory are not affected by changing the 
overlay map, you can compare the operation of a program in your target 
memory with one in overlay memory. 


Command 

Comments 

>CLM 

Clear any previous mapping: 

>MAP 1000 to 7FFF-.R0 

Map ROM over existing target program 

>LOV 1000 to 7FFF 

Copy target program into Overlay Memory 

>ASM 2000 

Use line assembler to make a patch 

(Assembler commands) 


>RNV 

Run patched version 

>STP;CLM;RVN 

Stop, Remove Map, Run normal version 

>STP;MAP 1000 to 7FFF:R0;RNV 

Stop, Restore Map, Run patched version 
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SET MEMORY MAP (cont.) 


If you don’t have target memory to work with, and you still want to 
compare two programs, you can use a trick of overlay memory allocation. 
This particular example assumes you have 128K or more of overlay 
memory. 


Command 

Comments 

>CLM 

Clear previous map 

>GR0 = 1000 LEN 8000 

Will save some typing 

>MAP GR0 

Map 32K bytes for code space 

>DNL 

(Download commands and records) 

Download first program into overlay 

>MAP GR0:TGT 

Unmap code space (The data is still 
in Overlay RAM) 

>MAP GR0 + 10000 

Remap but at higher address range. 

The first program now "exists" again 
but in a higher address range. 

>MAP GR0 

Now map more overlay at the normal 
range 

>DNL 

(Download commands and records) 

Download second program. 

Now you have a copy of both programs. 

>MAP GR0:TGT;MAP GRO + 20000 

Relocates second program out of the way 

>MAP GRO +10000:TGT;MAP GRO 

Relocates first program back to normal 
address range. 
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CLEAR MEMORY MAP 


Command 


Result 


CLM 


The entire address range is 
assigned the TGT attribute. 


Comments 

This command clears all addresses from the overlay map. 
This command is valid only in pause mode. 
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OVERLAY MEMORY ENABLE 


Command 


Result 


OVE = SP + SD 


OVE = SP 


OVE = SD 


OVE = ALL 


OVE = SC <0,3,4> 


Comments 


Both supervisor program and 
supervisor data space are 
decoded by the overlay 
memory. 


Only supervisor program status 
space accesses are decoded by 
overlay memory. 


Only supervisor data status 
space accesses are decoded by 
overlay memory. 

Enables overlay for all spaces. 
(68000/08: spaces 1, 2, 5, 6, 7) 
(68010/20: spaces 0-7) 

Enables overlay memory for a 
specific space (0, 3, 4) as 
additional memory space 
(68010/20). 


This command allows you to utilize overlay memory as SP, SD, UP, UD, 
CPU and ALL. 


/ continued ) 
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OVERLAY MEMORY ENABLE (cont.) 


Status 

Mnemonic 

Description 

Space 

0 


Unnamed (68010/20) 

1 

UD 

User data 

2 

UP 

User program 

3 


Unnamed (68010/20) 

4 


Unnamed (68010/20) 

5 

SD 

Supervisor data 

6 

SP 

Supervisor program 

7 

CPU 

Target microprocessor space 


Overlay memory will respond to an access only if a mapped address and 
the current OVE status match the cycle being executed. For more 
information about the eight status spaces, see the Raw Trace section and 
the 16 Bit Microprocessor Users Manual or the MC68020 32 Bit 
Microprocessor Users Manual. 

SP is code space. The processor encodes it as supervisor program status. 

SD is data space. The processor encodes it as supervisor data. 

Overlay memory cannot be divided between SP and SD on the same map. 
It is either all one (SP, or the other (SD), or all both (SP+SD). 

To display the value of the current status being used for memory mode 
access, use the MMS command (page 5-81). 
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LOAD OVERLAY MEMORY 


Command 


Result 


LOY <rcinge> Move data from the target 

system memory to the Emulator 
overlay memory in the specified 
address range. 


Comments 


This command valid only in pause mode. 

In order to load overlay memory from the target memory, you must have a 
target system interfaced with the ESI800 Emulator and have overlay 
memory installed and mapped. 

In order to load a target memory range into the overlay memory at a 
different address, use the LOV command, then do a block move (BMO) of 
the range. 

Use the YFO command (page 5-66) to verify the memory move. 
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VERIFY OVERLAY MEMORY 


Command 


Result 


VFO <range> Compare the specified range in 

the target memory to the same 
range in the overlay memory. 

If there are no differences 
between the data in the overlay 
and target, the Emulator 
prompts you for the next 
command. 

If there are any differences, the 
address of each difference 
displays: 

<ADDRESS> = XX NOT YY 

“XX” denotes the data present 
in overlay memory. “YY” is the 
data at that location in the target 
system memory. 


Comments 


This command is valid only in pause mode. 
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OVERLAY MEMORY SPEED 


Command 


Result 


ovs = <0-7> (<1-7> 68020) 


Overlay memory will either 
supply a DTACK or not, 
according to the specified 
parameter. 


Comments 


Use this register to determine whether overlay memory will return a 
DTACK to the CPU. 

DISPLAY 

The current value of OVS is displayed when the memory map is displayed. 
OVS may be loaded with one of seven parameters: 


0 = No DTACK supplied by overlay memory 
(this does not apply to the 68020) 

1 = No delay, address strobe returned to 680XX as DTACK 

2 = +1 cycle delay 

3 = +2 cycles delay 

4 = +3 cycles delay 

5 = +4 cycles delay 

6 = +5 cycles delay 

7 = +6 cycles delay 


When overlaying PROM, it may be necessary to set MMS = <space code> + 
OVO. This will allow the overlay to operate independently of the system. 
A DTACK is automatically supplied when this is in effect. 


( continued ) 
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Registers 

The following is a complete list of all the registers in the Emulator. These 
registers can be logically divided into four groups. Please note that there 
are separate lists of registers for the 68000/08, 68010, and 68020 
microprocessors. 

■ microprocessor registers 

■ general Emulator registers 

■ event system registers 

■ bus error registers 

Each register accepts one or two of three value types: 

■ integer values 

■ range values 

■ don’t care values 

Registers that accept range and don’t care types can also be assigned 
integer values. 
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Section 5: System Commands 


68000/08/10/20 Target Microprocessor Registers 

Name 

Description 

Type 

Length (bits) 

PC 

program counter register 

Int 

24 

USP 

user stack pointer register 

Int 

24 

SSP 

supervisor stack pointer register 

Int 

24 

SR 

status register 

Int 

10 

AO 

address register #0 

Int 

32,16 

A1 

address register #1 

Int 

32,16 

A2 

address register #2 

Int 

32,16 

A3 

address register #3 

Int 

32,16 

A4 

address register #4 

Int 

32,16 

A5 

address register #5 

Int 

32,16 

A6 

address register #6 

Int 

32,16 

DO 

data register #0 

Int 

32,16,8 

D1 

data register #1 

Int 

32,16,8 

D2 

data register #2 

Int 

32,16,8 

D3 

data register #3 

Int 

32,16,8 

D4 

data register #4 

Int 

32,16,8 

D5 

data register #5 

Int 

32,16,8 

D6 

data register #6 

Int 

32,16,8 

D7 

data register #7 

Int 

32,16,8 


Additional 68010 Target Microprocessor Registers 

Name 

Description 

Type 

Length (bits) 

VBR 

vector base register 

Int 

24 

SFC 

source function code register 

Int 

3 

DFC 

destination function code register 

Int 

3 


( continued ) 


5-69 


ES 1800 Emulator Reference Manual for 68000 Series Microprocessors 

Additional 68020 Target Microprocessor Registers 


Name 

Description 

Type 

Length (bits) 

CACR 

cache control 

Int 

32 

CAAR 

cache address 

Int 

32 

MSP 

master stack pointer 

Int 

32 

ISP 

interrupt stack pointer 

Int 

32 

PC 

program counter 

Int 

32 

VBR 

vector base register 

Int 

32 

USP 

user stack pointer 

Int 

32 


General Emulator Registers 


Name 

Description 

Type 

Length (bits) 

DFB 

default base 

Int 

8 

GD0-GD7 

general purpose data 

DC 

32 

GR0-GR7 

general purpose range 

Range 

32 

IDX 

repeat index register 

Int 

32 

LIM 

repeat limit register 

Int 

32 

MMP 

memory mode pointer 

Int 

32 

MMD 

memory mode destination 

DC 

16 

MMS 

memory mode status 

DC 

16 

OVE 

overlay enable 

DC 

8 

TST 

terminator for repeats 

Int 

32 


5-70 





Section 5: System Commands 


Event Monitor System Registers 


Name 

Description 

Type 

Length 

AC1.1-AC1.4 

Address Comparator 

Range 

24 

AC2.1-AC2.4 

Address Comparator 

Range 

24 

DC1.1-DC1.4 

Data Comparator 

DC 

16 

DC2.1-DC2.4 

Data Comparator 

DC 

16 

S1.1-S1.4 

Status Comparator 

DC 

16 

S2.1-S2.4 

Status Comparator 

DC 

16 

CL.1-CL.4 

Count Limit Comparator 

Int 

16 

LSA.1-LSA.4 

Logic State Comparator 

DC 

16 

SIA 

Special Interrupt Address 

Int 

32 


Each register has a separate display base. The display base is viewed and 
changed with the BAS command (see page 5-79). Display bases are often 
changed for registers such as the Event Monitor LSA comparators, which 
you might like to see in binary, and the CL register, which you might want 
to see in decimal. 

The CPU registers and the Event Monitor registers can be displayed as a 
group by using the DR and DES n commands. 

See Event Monitor System (Chapter 7 for the 68000/08/10 or Chapter 8 for 
the 68020) for Event Monitor System register descriptions. 

The complete register set can be loaded from or saved to EEPROM. 
Executing a SAV or LD will copy all system variables. A SAV 1 or LD 1 
will copy only the register group. 


( continued ) 
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68000/08/10 BUS ERROR REGISTERS 

The Emulator can send a bus error to the MPU for two different reasons: 

■ When executing the CYC command, a bus error is forced so 
the long stack of information will be available to the 
firmware that simulates bus cycles. 

■ When the BTE switch is ON, emulation will be aborted by 
an internally generated bus error if the target system holds 
the address strobe asserted for a sufficient length of time. 

In either case, the entire stack of registers is saved in registers with specific 
names. The registers may be examined and/or modified. 

The registers named MSK and R0 -R14 contain internal information that 
is not documented by Motorola. Modification of any of these registers 
may result in unpredictable operation of the 68010 MPU. 
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Figure 7. 68000/08/10 Bus Error Registers 

68000/68008 68010 


Program Counter High 
Program Counter Low 

Status Register _ 

Instruction Regsiter 
Access Address High 
Access Address Low 

R/W | l/N | FC 


Internal 
Information 
16 Words* 


Status Register 

SR x 

Program Counter High 

PC \ 

Program Counter Low 

XOOO/Vector Offset 

FMT ) 

Special Status Word 

SSW i 

Fault Address High 

FA 

Fault Address Low 

Unused 


Data Output Buffer 

DOB 

Unused 


Data Input Buffer 

DIB 

Unused 


Instruction Input Buffer 

IIB 


MSK 


RO 


R1 1 


R2 > 


R3 [ 


R4 


R5 


R6 


R7 


R8 


R9 


RIO 


R11 


R12 


R13 / 


R14 / 


Valid after 
any error 
message break 


Valid only 
After Bus 
Error on 
"CYC” 
Execution 


* These registers contain internal Information that is not 
documented by Motorola. Modification of these registers 
may result in unpredictable operation of the 68010/68020 
MPU. 
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68020 BUS ERROR REGISTERS 

The ESI800 uses the same bus error stack format internally as the 68020 
chip does externally in the target sytem when the BTE switch is ON and an 
internal bus error occurs. 

This information is available to the user by keying in the register name. 
Please refer to the tables that follow. 

These registers are internal representations of the conditions listed above 
and do not reflect normal bus error information in the target system. 

The first three registers in both the short and long bus cycle are always 
available after each break in emulation. The remainder are only available 
when the three conditions occur: 

■ the BTE switch is ON 

■ an internal bus error occurs 

■ register name is keyed in 
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Section 5: System Commands 


Figure 8 . 68020 Bus Error Registers 

68020 

Short Bus Cycle 
Fault Stack Frame 


Status Register 

Program Counter Hiqh 

Program Counter Low 

FMT/Vector Offset 

Internal Register 1 

Special Status Word 

Instruction Pipe C 

Instruction Pipe B 

Fault Address High 

Fault Address Low 

Internal Register 2 High 

Internal Register 2 Low 

Data Output Buffer 

Data Output Buffer 

Internal Register 3 High 

Internal Register 3 Low 


SR 
I PC 
BFMT 
IR1 
SSW 

| IPS 

1 FA 
} IR2 
\ DOB 
\ IR3 


68020 

Long Bus Cycle 
Fault Stack Frame 


Status Reqister 

Program Counter Hiqh 

Program Counter Low 

FMT/Vector Offset 

Internal Register 1 

Special Status Word 

Instruction Pipe C 

Instruction Pipe B 

Fault Address High 

Fault Address Low 

Internal Register 2 High 

Internal Register 2 Low 

Data Output Buffer 

Data Output Buffer 

Internal Register 3 High 

Internal Register 3 Low 

Internal Register 4 High 

Internal Register 4 Low 

Staqe B Address High 

State B Address Low 

Internal Register 5 High 

Internal Reqister 5 Low 

Data Input Buffer 

Data Input Buffer 

Internal Register 6H 

Internal Register 6L 

Internal Register 7H 

Internal Register 7L 

Internal Register 8H 

Internal Register 8L 

Internal Reqister 9H 

Internal Register 9L 

Internal Register 10H 

Internal Register 10L 

Internal Register 11H 

Internal Register 11L 

Internal Reqister 12H 

Internal Register 12L 

Internal Register 13H 

Internal Register 13L 

Internal Register 14H 

Internal Register 14L 

Internal Register 15H 

Internal Register 15L 

Internal Register 16H 

Internal Register 16L 


SR 

PC 

BFMT 

IR1 

SSW 

IPS 

FA 

IR2 

DOB 

IR3 

IR4 

SBA 

IR5 

DIB 

IR6 

IR7 

IR8 

IR9 

IRA 

IRB 

IRC 

IRD 

IRE 

IRF 

IRG 
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DISPLAY/LOAD MICROPROCESSOR REGISTERS 


Command 


Result 


DR DR causes the system to display 

the contents of all the micro¬ 
processor registers. 

CLR The CLR command clears 

registers A0-A6 and D0-D7 to 
zero. 

LDV Load the reset vectors into the 

stack pointer and program 
counter. The reset vectors can 
also be loaded by the RNV and 
RBV commands. These load the 
vectors and enter run mode 
(page 6-5). 


Comments 


This command is valid only in pause mode. 

If keyed in while running, the values will be as they were before entering 
run emulation. They will not accurately reflect current values. 

Refer to the Motorola 16 Bit Microprocessors Users Manual or the 
MC68020 Microprocessors Users Manual for the default power-up values 
of the microprocessor registers. Register values may be saved to and 
loaded from EEPROM. 
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DISPLAY/LOAD MICROPROCESSOR REGISTERS (cont.) 


The CPU registers are automatically copied from Emulator RAM to the 
microprocessor when run mode is entered. When emulation is broken, they 
are copied from the processor to Emulator RAM. 

If a CPU register is loaded with a value during run mode, a warning 
message will be displayed. This warning informs you that the value you 
are entering will not be sent to the pod CPU during emulation. The value 
is stored in the Emulator’s internal RAM, but when emulation is broken, 
the new value of the CPU register overwrites the value just entered. 

The display of the SR (and CCR in the 68020) register is different from 
that of the other CPU registers. The flags are more conveniently decoded 
by using an alpha character to indicate whether the flag was set or cleared 
by a particular instruction cycle. If the flag is clear, you see a Q as a place 
holder. If set, the following characters describe the flag. 


X - Trace on execution (SR,68020) 0 * Overflow 

M,I - Master/Interrupt state 
0-7 - Interrupt priority mask 
T - Trace mode 
S,U - Supervisor/User state 
Z - Zero 
N - Negative 
X - Extend (CCR) 

C - Carry 


( continued ) 
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DISPLAY/LOAD MICROPROCESSOR REGISTERS (cont.) 


Examples 


(68000/08 microprocessor) 

-0- -1- -2- -3- - 4 - -5- -6- ~ 7 - 

D = 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A = 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

PC = 000000 SSP = 000000 USP = 0000000 SR = TS7XNZVC 


(68010 microprocessor) 

-0- -I- -2- -3- -4- -5- -6- - 7 - 

D = 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 
A = 00000000 00000000 00000000 00000000 00000000 00000000 00000000 

PC=000000 VBR=000000 SFC=0 DFC=0 SSP=000000 USP=000000 SR=TS7XNZVC 


(68020 microprocessor) 







- 0 - - 1 - 

- 2 - 

- 3 - 

- 4 - 

- 5 - 

- 6 - 

- 7 - 

D = 00000000 00000000 

00000000 

00000000 

00000000 

00000000 

00000000 

00000000 

A = 00000000 00000000 

00000000 

00000000 

00000000 

00000000 

00000000 


SR = XSI7 



SFC = 0 


MSP = 

00000000 

OCR = XNZVC 

CAAR = 

00000000 

DFC = 0 


ISP = 

00000000 

PC = 00000000 

CACR = 

00000000 

VBR = 00000000 

USP = 

00000000 
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SET/DISPLAY REGISTER DEFAULT BASE 


Command 


Result 


BAS <register> 


Display the decimal base of the 
specified register. 


#0 

- default 

#2 

- binary 

#8 

- octal 

#10 

- decimal 

#16 

- hexadecimal 


If the register has not been 
assigned a separate display base, 
the current default base is 
displayed. 


BAS <register>= <base value> Set the display base of the 

register to the base value. 

If the base value for a register is 
set to 0, the current default base 
is used for display. 


Comments 


Base values may be stored in EEPROM and automatically loaded on 
power-up or manually retrieved using the LD or LD 1 command. 

Be careful when setting private display bases to unusual bases such as 4, 7 
or 11. The Emulator operates correctly, but the results may be confusing. 
If you set the base value to a value other than hexadecimal, decimal, octal. 


( continued ) 


5-79 






SET/DISPLAY REGISTER DEFAULT BASE (cont.) 


or binary, the Emulator displays a question mark (?) preceding the base 
value when asked to display the base in effect. 

Refer to the default base command, DFB (page 5-85), for displaying the 
system global default base. 


Examples 


>BAS SR 
DEFAULT: #16 
>BAS SR=#8 
>BAS SR 
#8 


>GD3 

$0000AA55 
>BAS GD3 = 2 
>BAS GD3 
#2 

>GD3 

%00000000000000001010101001010101 


The value of GD3 will always be displayed in binary until you change its 
display base or the Emulator is powered down. 
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MEMORY MODE STATUS REGISTER 


Command 


Result 


MMS 

MMS = <MMS memory space> 

MMS = <MMS memory space> + 
TGO 

MMS = <MMS memory space> + 

ovo 

MMS = <MMS memory space> + 
NRM 

MMD 


Display the value of the current 
status being used for memory 
accesses (peeks and pokes). 

Set the status space for memory 
accesses. 

Map overlay memory and 
examine target (with no impact 
on mapped memory). 

Map target system and examine 
overlay memory. OVO 
parameter results in no bus 
cycles entering the target 
system. 

Returns system to default mode 
after TGO or OVO has been 
specified. 

MMD is used like MMS, but for 
block verifies and block moves. 


( continued) 
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MEMORY MODE STATUS REGISTER (cont.) 


Comments 


One of eight memory spaces can be selected to operate memory with: 


SCO = 

unused (used only by 68010 

and 68020) 

SCI = 

UD (user data) 


SC2 = 

UP (user program) 


SC3 = 

unused (used only by 68010 

and 68020) 

SC4 = 

unused (used only by 68010 

and 68020) 

SC5 = 

SD (supervisor data) 


SC6 = 

SP (supervisor program) 


SC7 = 

CPU (interrupt acknowledge 

or CPU space cycle) 
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MEMORY MODE POINTER 


Command 


Result 


MMP 

Display the current value of the 
memory mode pointer. 

MMP = <exp> 

Assign the value <exp> to the 
memory mode pointer. 


Comments 


The MMP is the last address examined while in memory mode. If you 
enter memory mode without specifying an address, the MMP value is used 
as the entry point. 

This default power-up value of the MMP register is zero. This register 
may be saved to and loaded from EEPROM. 

The memory mode pointer is automatically modified when you scroll to a 
new address after entering memory mode. When you exit memory mode, 
the MMP reflects the last address examined. For more information on 
memory mode, see page 6-15. 


( continued ) 
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MEMORY MODE POINTER (cont.) 


Examples 

Set an address comparator to the last address examined in memory mode. 

>M 6000 

(examine memory until you find a location of interest) 

$006013 5A >X 
>AC1=MMP 
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DEFAULT BASE 


Command 

Result 

DFB 


Display the global default base. 

On power-up the default base is 
hexadecimal unless another 
default base has been loaded by 
the EEPROM on power-up. 

DFB = #2 


Set the default base to binary. 

DFB = #8 


Set the default base to octal. 

DFB = #10 


Set the default base to decimal. 

DFB = #16 


Set the default base to 
hexadecimal. 

Comments 

Various operators tell the Emulator what base an input value is in. They 
are: 

Operator 

Description 

Example 

<%> 

Binary 

%10011100001 111 

<\> 

Octal 

\23417 

<#> 

Decimal 

#9999 

<$> 

Hexadecimal 

S270F 


( continued ) 
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DEFAULT BASE (cont.) 


Base prefixes can be used any time to enter a value in a base different than 
the default base. Values not preceded by one of these prefixes are 
presumed by the Emulator to be in the default base. 

For example, if you set the global default base to binary, and you then 
want to assign a value to a register in a base other than binary, use a base 
prefix. 

The Emulator works correctly with any base between 2 and 16. However, 
if you set an uncommon base, such as 5 or 9, the results of assignments and 
commands may be confusing. 

If the base is outside the allowable range, an error message is displayed and 
the Emulator defaults to the hexadecimal base. 
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GENERAL PURPOSE DATA REGISTERS 


Command 


Result 


GD<0-7> 


Display the value of the 
specified register. 


GD<0-7> = <value> Assign a value to one of the 

eight general purpose data 
registers. 


Comments 


Use the general purpose registers as arguments to commands to save key 
strokes when using values repeatedly. They can also be used to save space 
in macro definitions. 

These general purpose registers may be used in place of integer or don’t 
care values in command statements. 

The general purpose data registers can be loaded with any integer or don’t 
care value. They will not accept a range value. 


Examples 


General purpose data register four is loaded with 5000. GD4 can now be 
used anywhere you would use this integer value. 


>GD4 = 5000 


( continued ) 
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GENERAL PURPOSE DATA REGISTERS (cont.) 


If you are looking for a specific pattern on the LSA pod lines in more than 
one event group, assign a general purpose data register the value you are 
looking for. All subsequent LSA assignments can use this register. 


>GD2 = %01100101100 DC %10011 


>LSA = GD2; LSA.2 = GD2 


>GD3 = 'datpatl DC $FF00 

Looking for one byte 

>DC1 = GD3 

of a specified word? 


You may choose to use a general purpose register instead of memory mode 
status mnemonics. 
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GENERAL PURPOSE ADDRESS REGISTERS 


Command 


Result 


GR<0-7> 


Display the value of the 
specified register. 


GR<0-7> = <value> Assign a value to one of the 

eight general purpose address 
registers. 


Comments 


Use the general purpose registers as arguments to commands to save key 
strokes when using values repeatedly. They can also be used to save space 
in macro definitions. 

These general purpose registers may be used in place of integer or range 
values in command statements. 

The general purpose data registers can be loaded with any integer or range 
value. 


Examples 


General purpose address register 4 is loaded with 5000. GR4 can now be 
used wherever you would use this integer value. 


>GR4 = 5000 


( continued ) 
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GENERAL PURPOSE ADDRESS REGISTERS (cont.) 


Assign a register a range you will be using often. Then use it as a 
parameter for other commands. 


>GR0 = 'start_code LEN 20 
>DIS GRO 
>DB GRO 


If you do not know the absolute address in your target hardware, but have 
downloaded a symbol table containing them, then use the symbol names 
instead of looking up the hardware specifications. 


>GR2 = 'ram LEN 1 ram_len 

Initialize GR2 

>SF 0,GR2 

Run a RAM test on your RAM 

>AC1 = GR2 

Set a breakpoint on any RAM access 

>WHE AC1 THE BRK 






TEST REGISTER 


Command 


Result 


TST The test register is is used to 

stop repeating commands. It is 
set to an expression in a 
command line. When it 
becomes zero, the repeat halts. 


Comments 


See The Repeat Operator for more detailed information. (See page 5-122). 


( continued ) 
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Trace Memory 

Trace memory commands deal with the display and disassembly of trace 
memory data. Refer to the Event Monitor System (Section 7 for 
68000/08/10 or Section 8 for 68020) for sophisticated uses of trace 
memory. 

Trace memory is 70 bits wide and 2046 bus cycles deep (101 bits wide for 
68020). Some bus cycles may be used for marks to identify start and stop 
points within the trace buffer. An unqualified trace contains all bus 
activity for the last 2046 bus cycles. Trace can be searched for a particular 
address, data or status. 

During emulation, the activity of the executing program is recorded and 
stored in trace memory. All address lines, data lines, processor status lines, 
and 16 bits of external logic-state are traced. This record becomes a 
history of the program. If something unexpected happens during program 
execution, trace memory can be reviewed to determine what happened. 
When used in conjunction with the trace disassembler, hardware and 
software problems may be found. 

Although trace memory cannot be accessed by the user during emulation, 
you can stop program execution at any point: either manually, or by using 
the Event Monitor System. The address, data and control signals of the 
most recently traced cycles may be reviewed. 

PERFORMANCE ANALYSIS (68020) 

A timer provides a time signature for each bus cycle captured in trace 
memory. Each line in trace memory is “stamped” with a time relative to 
when emulation started. 
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Section 5: System Commands 


Emulation 

TRACE MEMORY MODES (68020) 

The 68020 microprocessor is a 32 bit environment, while the trace and 
Event Monitor Systems are based on a 16 bit environment.The additional 
signals available with the 68020 microprocessor make it impossible to trace 
all 32 address, 32 data, and relevant status bits simultaneously. 

To enhance compatibility of these two environments, the ESI 800 has four 
trace memory modes. These four modes trace four combinations of 
address, data, and status bits giving you full coverage of the bits available 
with the 68020 microprocessor. 

The four trace memory modes and their respective bits combination are: 


Mode 

Address 

Data 

Status 

Timing 

LSA 

0 

24 

16 

19 

24 

16 

1 

24 

32 

19 

24 

0 

2 

32 

32 

11 

24 

0 

3 

32 

16 

21 

24 

6 


MODE SELECTION 

To determine which mode you would like to run in, first become familiar 
with what is presently in program memory. Decide whether your program 
requires the tracing of more address bits than data bits, or more data bits 
than address bits. Select the mode that will be most effective for the 
program that is going to be traced. 

When using the 68020 microprocessor it is required that prior to entering 
the run emulation mode you must designate which of the four trace 
memory modes you are going to use. Set parameter #4 on the SET menu 
(see page 5-5) is used to designate the mode. 

To look at raw trace you need to know what bits are traced in each mode. 
For run mode to operate correctly with trace memory modes the 
comparator registers are required to be set up appropriately. (Refer to 
page 8-14 for more detailed information). 
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DISPLAY RAW TRACE BUS CYCLES 


Command 


Result 


DRT 


Display the last page of bus 
cycles recorded in trace 
memory. 


DRT <line number> 


Displays a page of the trace 
buffer starting with <line 
number>. 


DRT <range> Display the range of line 

numbers. XON and XOFF may 
be used to start and stop 
scrolling if the range is larger 
than the console display. 

Note that the range is a range of 
bus cycles, not the address 
recorded in the trace memory. 


Comments 


Set parameter #13 sets the page length. (Refer to page 5-3). 

This command is valid only in pause mode. 

See DST (68020), page 5-108 for an alternative way to display the raw 
trace bus cycles. 

NOTE: The sequence numbers in DT, DTB, and DTF (instructions) 
correlate with the line numbers displayed in DRT (bus cycles). However, 
one or more bus cycles in the DRT display may make up one instruction on 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


the DT, DTB or DTF displays. These displays may have missing sequence 
numbers indicating a multiple bus cycle instruction has been executed. 
Also, the sequence number (SEQ #) may be repeated when two byte wide 
instructions were executed from continuous addresses. 


Examples 


68000/08/10 

>DRT 


LINE 

ADDRESS 


DATA 

R/W 


FC 

IPL 

LSA - 8 

7 - 0 

#20 

00100A 

> 

3080 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#19 

00100C 

> 

B03C 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#18 

00100E 

> 

0039 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#17 

001010 

> 

6C02 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#16 

001012 

> 

5E40 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#15 

001014 

> 

5740 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#14 

001016 

> 

41 FA 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#13 

001018 

> 

03F0 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#12 

00101A 

> 

3140 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#11 

00101C 

> 

FF00 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#10 

00101E 

> 

1140 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#9 

001308 

> 

0037 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#8 

001020 

> 

FFF7 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#7 

001022 

> 

60F0 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#6 

0013FF 

> 

37 

W 

OVL 

SP 

0 

%11111111 

%11111111 

#5 

001024 

> 

4E71 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#4 

001004 

> 

B03C 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#3 

001006 

> 

0039 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#2 

001008 

> 

6C02 

R 

OVL 

SP 

0 

%11111111 

%11111111 

#1 

00100A 

> 

3080 

R 

OVL 

SP 

0 

X11111111 

%11111111 

#0 

BREAK 










( continued ) 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


68020 

MODE 0 DISPLAY 


>DRT 

LINE 

ADDRESS 


DATA 

R/W 


FC 

I PL 


LSA - 8 

7 - 0 

TIME 

#20 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 


%11111111 

xiiiiim 

307.418 MS 

#19 

F0053E 

> 

FFF8 

R 

TAR 

SP 

0 


%11111111 

xiiiiim 

307.418 MS 

#18 

F00540 

> 

6024 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.419 MS 

#17 

F00542 

> 

4A03 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.420 MS 

#16 

F00534 

> 

007E 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.421 MS 

#15 

F00536 

> 

301A 

R 

TAR 

SP 

0 


X11111111 

%11111111 

307.421 MS 

#14 

F00538 

> 

E309 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.422 MS 

#13 

F0053A 

> 

6506 

R 

TAR 

SP 

0 


%11111111 

xiiiiim 

307.423 MS 

#12 

F005BA 

> 

0000 

R 

TAR 

SD 

0 


%11111111 

%i 1111111 

307.424 MS 

#11 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.424 MS 

#10 

F0053E 

> 

FFF8 

R 

TAR 

SP 

0 


%11111111 

%i 1111111 

307.425 MS 

#9 

F00540 

> 

6024 

R 

TAR 

SP 

0 


%11111111 

X11111111 

307.426 MS 

#8 

F00542 

> 

4A03 

R 

TAR 

SP 

0 

IP 

%11111111 

xm m 11 

307.427 MS 

#7 

F00534 

> 

007E 

R 

TAR 

SP 

0 

IP 

%11111111 

X11111111 

307.427 MS 

#6 

F00536 

> 

301A 

R 

TAR 

SP 

0 

IP 

%11111111 

xm 11111 

307.428 MS 

#5 

F00538 

> 

E309 

R 

TAR 

SP 

0 

IP 

%11111111 

X11111111 

307.429 MS 

#4 

F0053A 

> 

6506 

R 

TAR 

SP 

0 

IP 

xiiiiim 

X11111111 

307.429 MS 

#3 

F005BC 

> 

0000 

R 

TAR 

SD 

0 

IP 

%i 1111111 

X11111111 

307.430 MS 

#2 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 

IP 

%i 1111111 

xm m 11 

307.431 MS 

#1 

#0 

F0053E 

BREAK 

> 

FFF8 

R 

TAR 

SP 

0 

IP 

%i 1111111 

xiiiiim 

305.431 MS 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


>DRT 

LINE 

ADDRESS 


DATA 

R/W 

MODE 

68020 

1 DISPLAY 

FC I PL 


DS 

sz 

ocs 

TIME 


#20 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

s 

#19 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#18 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#17 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#16 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#15 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#14 

F00538 

> 

E309FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#13 

F0053A 

> 

6506FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#12 

F005B4 

> 

004AFFFF 

R 

TAR 

SD 

0 


01 

10 

0 

1.396 

S 

#11 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#10 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#9 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#8 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#7 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#6 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 

#5 

F00538 

> 

E309FFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#4 

F0053A 

> 

6506FFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 

#3 

F005B6 

> 

0056FFFF 

R 

TAR 

SD 

0 

IP 

01 

10 

0 

1.396 

S 

#2 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#1 

#0 

F0053E 

BREAK 

> 

FFF8FFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 


( continued ) 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


68020 

MODE 2 DISPLAY 


>DRT 

LINE 

ADDRESS 


DATA 

R/W 

#20 

FFF00506 

> 

OOCOFFFF 

R 

#19 

FFF00508 

> 

206DFFFF 

R 

#18 

FFF0050A 

> 

041AFFFF 

R 

#17 

FFF21C72 

< 

FFFBFFFB 

W 

#16 

FFF21C74 

< 

00400040 

u 

#15 

FFF21C6E 

< 

FFF2FFF2 

w 

#14 

FFF21C70 

< 

04220422 

w 

#13 

FFF0050C 

> 

2268FFFF 

R 

#12 

FFF0050E 

> 

000CFFFF 

R 

#11 

FFF2041A 

> 

FFF2FFFF 

R 

#10 

FFF2041C 

> 

0422FFFF 

R 

#9 

FFF00510 

> 

4A29FFFF 

R 

#8 

FFF00512 

> 

0007FFFF 

R 

#7 

FFF2042E 

> 

FFFBFFFF 

R 

#6 

FFF20430 

> 

0040FFFF 

R 

#5 

FFF00514 

> 

6A02FFFF 

R 

#4 

FFF00516 

> 

6106FFFF 

R 

#3 

FFFB0047 

> 

44FFFFFF 

R 

#2 

FFF00518 

> 

4CDFFFFF 

R 

#1 

FFF0051A 

> 

0300FFFF 

R 

#0 

BREAK 






FC 

DS 

sz 

ocs 

TIME 


TAR 

SP 

01 

10 

1 

1.215 

s 

TAR 

SP 

01 

00 

0 

1.215 

S 

TAR 

SP 

01 

10 

1 

1.215 

S 

TAR 

SD 

01 

00 

0 

1.215 

S 

TAR 

SD 

01 

10 

1 

1.215 

S 

TAR 

SD 

01 

00 

0 

1.215 

S 

TAR 

SD 

01 

10 

1 

1.215 

S 

TAR 

SP 

01 

00 

0 

1.215 

S 

TAR 

SP 

01 

10 

1 

1.215 

S 

TAR 

SD 

01 

00 

0 

1.215 

S 

TAR 

SD 

01 

10 

1 

1.215 

S 

TAR 

SP 

01 

00 

0 

1.215 

S 

TAR 

SP 

01 

10 

1 

1.215 

S 

TAR 

SD 

01 

00 

0 

1.215 

S 

TAR 

SD 

01 

10 

1 

1.215 

S 

TAR 

SP 

01 

00 

0 

1.215 

S 

TAR 

SP 

01 

10 

1 

1.215 

S 

TAR 

SD 

10 

01 

0 

1.215 

S 

TAR 

SP 

01 

00 

0 

1.215 

S 

TAR 

SP 

01 

10 

1 

1.215 

S 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


MODE 


>DRT 

LINE 

ADDRESS 

DATA 

R/W 


#20 

FFF21C5E 

< FFFB 

W 

TAR 

#19 

FFF21C60 

< 0040 

W 

TAR 

#18 

FFF21C5A 

< FFF2 

W 

TAR 

#17 

FFF21C5C 

< 0422 

W 

TAR 

#16 

FFF21C56 

< 0000 

W 

TAR 

#15 

FFF21C58 

< 0000 

u 

TAR 

#14 

FFF21C52 

< 0000 

w 

TAR 

#13 

FFF21C54 

< 0000 

w 

TAR 

#12 

FFF21C4E 

< 0000 

w 

TAR 

#11 

FFF21C50 

< 0008 

w 

TAR 

#10 

FFF21C4A 

< 0000 

w 

TAR 

#9 

FFF21C4C 

< 00FE 

w 

TAR 

#8 

FFF21C46 

< 0000 

u 

TAR 

#7 

FFF21C48 

< 0003 

w 

TAR 

#6 

FFF21C42 

< 0000 

u 

TAR 

#5 

FFF21C44 

< 0003 

w 

TAR 

#4 

FFF21C3E 

< 0014 

w 

TAR 

#3 

FFF21C40 

< oooc 

w 

TAR 

#2 

FFF21C3A 

< 0000 

w 

TAR 

#1 

FFF21C3C 

< 0001 

w 

TAR 

#0 

BREAK 





68020 
3 DISPLAY 


FC 

IPL 


LSA - O 

TIME 


SD 

O 

IP 

%111111 

500. 

183 

MS 

SD 

O 

IP 

%111111 

500. 

184 

MS 

SD 

0 

IP 

%111111 

500. 

184 

MS 

SD 

0 

IP 

%111111 

500. 

185 

MS 

SD 

0 

IP 

%111111 

500. 

186 

MS 

SD 

0 

IP 

%111111 

500. 

186 

MS 

SD 

0 

IP 

%111111 

500. 

,187 

MS 

SD 

0 

IP 

%111111 

500. 

.188 

MS 

SD 

0 

IP 

%111111 

500. 

,188 

MS 

SD 

0 

IP 

%111111 

500. 

.189 

MS 

SD 

0 

IP 

%111111 

500. 

.190 

MS 

SD 

0 

IP 

%111111 

500. 

.190 

MS 

SD 

0 

IP 

%111111 

500. 

.191 

MS 

SD 

0 

IP 

%111111 

500, 

.192 

MS 

SD 

0 

IP 

X111111 

500, 

.192 

MS 

SD 

0 

IP 

%111111 

500, 

.193 

MS 

SD 

0 

IP 

%111111 

500 

.193 

MS 

SD 

0 

IP 

%111111 

500 

.194 

MS 

SD 

0 

IP 

%111111 

500 

.195 

MS 

SD 

0 

IP 

%111111 

500 

.195 

MS 


LINE 


ADDRESS 

DATA 


Line number 0 in the trace buffer 
indicates the last bus cycle prefetched 
or executed before the Emulator went 
into pause mode. The larger the LINE 
number the further back in the history 
of the program you are viewing. You 
can get a good idea of the relationship 
of bus cycles to instructions by 
matching the bus cycle LINE numbers 
in the DRT to the SEQ# in the 
disassembled trace. 


The address displayed is where the bus 
cycle took place, along with the DATA 
written to, or read from, that address. 


( continued ) 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


R/W 

TAR/OVL 

RM (68020, Mode 3) 

FC 

V 

B 

BER 

IPL 

CD (68020, Mode 3) 


@ and 0 are data direction indicators. 
They display whether data was read 
from an address (0 ) or written to an 
address (0 ). These same indicators are 
used in the trace disassembly. 

Indicates whether the cycle was a read 
or a write. 

TAR/OVL indicates whether the access 
was in the target memory area or in the 
Emulator’s overlay memory (see DM 
command to determine what addresses 
are mapped). 

68020 RMC signal. Indicates the cycle 
was an indivisible read-modify-write 
cycle. 

Indicates the state of FCO-2. 

Marks all cycles that occurred after a 
memory write violation or memory 
access violation. 

Marks all bus cycles that occurred after 
a breakpoint. 

Indicates the BERR signal was asserted. 

Indicates the interrupt level encoded on 
the IPLO-2 lines. 

Indicates the CDIS signal was asserted. 


AV (68020, Mode 0,1,3) Indicates the AVEC signal was asserted. 


IP (68020, Mode 0,1,3) Indicates the IPEND signal was 

asserted. 

LSA LSA columns display the state of each 

pin of the LSA pod during that bus 
cycle. 
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DISPLAY RAW TRACE BUS CYCLES (cont.) 


NOTE: The same information that is 
recorded in the trace buffer can be used 
by the Event Monitor System to cause 
event actions. Therefore everything in 
the trace buffer can cause event actions 
such as selective tracing, counting, or 
breaking emulation (refer to the Event 
Monitor System, Section 7 for 
68000 / 08/10 or Section 8 for 68020 ). 

DS (68020, Mode 1, 2) Indicates the state of DSACK0 and 

DSACK1. 

SZ (68020, Mode 1, 2) Indicates the state of SIZ0 and SIZ1. 

OCS (68020, Mode 1, 2) Indicates whether the OCS signal was 

asserted. 

TIME (68020) Indicates the time elapsed since 

emulation was entered. 

YM (68000/10) Indicates the VMA signal was asserted. 

VP (68000/08/10) Indicates the VPA signal was asserted. 
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CLEAR TRACE MEMORY (68020) 


CLT 


Command 


Result 


All current trace memory is 
cleared. Applies to 68020 only. 
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DISASSEMBLE TRACE MEMORY 


Command 


Result 


DT 


DT <range> 


Disassemble and display the last 
instruction in trace memory. A 
sequence number is not 
included. Overwrites current 
display line. 

Disassemble a range of bus 
cycles, starting at the specified 
value and proceeding back in 
time. 


DT <value> 


Disassemble a page of trace 
starting at <value>. 


Comments 


This command is valid only in pause mode. 

A page is defined by the CRT length parameter in the SET menu. 

The sequence #0 is always the most recently recorded bus cycle in trace 
memory. If an argument is specified to the DT command, the values refer 
to the raw trace sequence numbers. 

The sequence number shown is a decimal value. For numbers larger than 
9, precede with a decimal ( @ ) base sign. 

When using the disassemble trace (DT) and the display register (DR) on the 
same line, make sure you enter DT before DR, because DT will overwrite 
the current line. It does this so that the STP;DT command used repeatedly 


( continued ) 
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DISASSEMBLE TRACE MEMORY (cont.) 


will give a listing similar to a program listing without the STP;DT line 
between each command. 

68020 

Disassemble trace (68020 microprocessor) requires the following: 

1. You must be in trace mode 2 (Set parameter #4, page 
5-3). An error message will display if you are not in trace 
mode. 

2. The CDS switch must be enabled (ON). 


Examples 


These two commands used in conjunction will give the user output similar 
to a program listing. 


>STP;DT 
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DISASSEMBLE TRACE MEMORY (cont.) 


>DT 0 
SEQ# 

ADDR 

OPCODE 

MNEMONIC 

OPERAND FIELDS AND BUS CYCLE DATA 

0051 

00000192 

64EA 

BCC.S 

$0000017E 

0047 

0000017E 

13C20000 

MOVE.B 

D2 f $0000A001 



A001 


0000A001<3C 

0044 

00000184 

D081 

ADD.L 

Dl ,D0 

0043 

00000186 

64000008 

BCC.W 

$00000190 

0039 

00000190 

D885 

ADD.L 

D5,D4 

0038 

00000192 

64EA 

BCC.S 

$0000017E 

0034 

0000017E 

13C20000 

MOVE. B 

D2,$0000A001 



A001 


0000A001<3C 

0031 

00000184 

D081 

ADD.L 

Dl ,D0 

0030 

00000186 

64000008 

BCC.W 

$00000190 

0026 

00000190 

D885 

ADD.L 

D5 # D4 

0025 

00000192 

64EA 

BCC.S 

$0000017E 

0021 

0000017E 

13C20000 

MOVE.B 

D2,$0000A001 



A001 


0000A001<3C 

0018 

00000184 

D081 

ADD.L 

D1,D0 

0017 

00000186 

64000008 

BCC.W 

$00000190 

0013 

00000190 

D885 

ADD.L 

D5 # D4 

0012 

00000192 

64EA 

BCC.S 

$0000017E 

0008 

0000017E 

13C20000 

MOVE.B 

D2,$0000A001 

> 


A001 


0000A001<3C 


SEQ# 


ADDR 

OPCODE 


Correlates the disassembled instruction to 
the raw trace bus cycle. 

This is a decimal number and must be 
preceded by a "#" sign when referenced for 
selective disassembling of the trace. This 
corresponds to the line number in the DRT 
command display. 

The memory address or location where the 
instruction was fetched. 

The machine-language (hex number) 
equivalent of the following assembly- 
language instruction. 


( continued ) 
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DISASSEMBLE TRACE MEMORY (cont.) 


MNEMONIC 

OPERAND FIELD 
BUS CYCLE DATA 


The command used to invoke the 
instruction. 

The assembly-language instruction. 

The bus cycle transaction, if any, that 
occurred as a result of the instruction. This 
includes any information written to, or read 
from, memory or I/O locations. If several 
branches are taken within a short period of 
time the trace disassembler may not be able 
to decide which branches were taken. 
These instructions are tagged with question 
marks. 
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SELECT TIMER FREQUENCY (68020) 


Command 

Result 

TIM = <n> 

Set time stamp resolution: 


1 - 0.1 MHz 


2- 1.0 MHz 


3 - 10.0 MHz 

TIM 

Display time stamp resolution. 


Default: 10 MHz 

Examples 


>TIM 


$00000003 
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DISPLAY RAW TRACE (68020) 


Command 


Result 


DST Display the last page of bus 

cycles recorded in trace memory 
with full timestamp resolution. 

DST <line number> Displays a page of the trace 

buffer starting with <line 
number >. 

DST <range> Display the range of line 

numbers. XON and XOFF may 
be used to start and stop 
scrolling if the range is larger 
than the console display. 

Note that the range is a range of 
bus cycles , not the address 
recorded in the trace memory. 


Comments 


Set parameter #13 sets the page length. (Refer to page 5-3). 

This command is valid only in pause mode. 

See DRT, page 5-94 for an alternative way to display the raw trace bus 
cycles. 
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DISPLAY RAW TRACE (68020) (cont.) 


Examples 


TRACE 


>DST 

LINE 

ADDRESS 

DATA R/W 


#20 

F0053C > 

51CB 

R 

TAR 

#19 

F0053E > 

FFF8 

R 

TAR 

#18 

F00540 > 

6024 

R 

TAR 

#17 

F00542 > 

4A03 

R 

TAR 

#16 

F00534 > 

007E 

R 

TAR 

#15 

F00536 > 

301A 

R 

TAR 

#14 

F00538 > 

E309 

R 

TAR 

#13 

F0053A > 

6506 

R 

TAR 

#12 

F005BA > 

0000 

R 

TAR 

#11 

F0053C > 

51CB 

R 

TAR 

#10 

F0053E > 

FFF8 

R 

TAR 

#9 

F00540 > 

6024 

R 

TAR 

#8 

F00542 > 

4A03 

R 

TAR 

#7 

F00534 > 

007E 

R 

TAR 

#6 

F00536 > 

301A 

R 

TAR 

#5 

F00538 > 

E309 

R 

TAR 

#4 

F0053A > 

6506 

R 

TAR 

#3 

F005BC > 

0000 

R 

TAR 

#2 

F0053C > 

51CB 

R 

TAR 

#1 

F0053E > 

FFF8 

R 

TAR 

#0 

BREAK 





MODE 0 


FC 

DS 

sz 

ocs 

TIME 


SP 

01 

00 

0 

0.3074177 

SEC 

SP 

01 

10 

1 

0.3074183 

SEC 

SP 

01 

00 

0 

0.3074194 

SEC 

SP 

01 

10 

1 

0.3074201 

SEC 

SP 

01 

00 

0 

0.3074207 

SEC 

SP 

01 

10 

1 

0.3074214 

SEC 

SP 

01 

00 

0 

0.3074221 

SEC 

SP 

01 

10 

1 

0.3074227 

SEC 

SD 

01 

10 

0 

0.3074235 

SEC 

SP 

01 

00 

0 

0.3074242 

SEC 

SP 

01 

10 

1 

0.3074248 

SEC 

SP 

01 

00 

0 

0.3074259 

SEC 

SP 

01 

10 

1 

0.3074266 

SEC 

SP 

01 

00 

0 

0.3074272 

SEC 

SP 

01 

10 

1 

0.3074278 

SEC 

SP 

01 

00 

0 

0.3074286 

SEC 

SP 

01 

10 

1 

0.3074292 

SEC 

SD 

01 

10 

0 

0.3074300 

SEC 

SP 

01 

00 

0 

0.3074306 

SEC 

SP 

01 

10 

1 

0.3074313 

SEC 


( continued ) 
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DISPLAY RAW TRACE (68020) (cont.) 


>DST 




TRACE MODE 1 





LINE 

ADDRESS 

DATA 

R/W 


FC 

DS 

sz 

ocs 

TIME 

#20 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955394 SEC 

#19 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955400 SEC 

#18 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955411 SEC 

#17 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955418 SEC 

#16 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955424 SEC 

#15 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955431 SEC 

#14 

F00538 

> 

E309FDFF 

R 

TAR 

SP 

01 

00 

0 

1.3955438 SEC 

#13 

F0053A 

> 

4506FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955444 SEC 

#12 

F005B4 

> 

004AFFFF 

R 

TAR 

SD 

01 

10 

0 

1.3955452 SEC 

#11 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

01 

00 

0 

1.1955459 SEC 

#10 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955465 SEC 

#9 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955476 SEC 

#8 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955483 SEC 

#7 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955489 SEC 

#6 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955495 SEC 

#5 

F00538 

> 

E309FFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955503 SEC 

#4 

F0053A 

> 

6506FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955510 SEC 

#3 

F005BC 

> 

0056FFFF 

R 

TAR 

SD 

01 

10 

0 

1.3955518 SEC 

#2 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

01 

00 

0 

1.3955524 SEC 

#1 

#0 

F0053E 

BREAK 

> 

FFF8FFFF 

R 

TAR 

SP 

01 

10 

1 

1.3955531 SEC 
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DISPLAY RAW TRACE (68020) (cont.) 


TRACE MODE 2 


>DST 

LINE 

ADDRESS 


DATA 

R/W 


#20 

FFF21C5E 

< 

FFFBFFFB 

w 

TAR 

#19 

FFF21C60 

< 

00400040 

w 

TAR 

#18 

FFF21C5A 

< 

FFF2FFF2 

u 

TAR 

#17 

FFF21C5C 

< 

04220422 

w 

TAR 

#16 

FFF21C56 

< 

00000000 

w 

TAR 

#15 

FFF21C58 

< 

00000000 

w 

TAR 

#14 

FFF21C52 

< 

00000000 

w 

TAR 

#13 

FFF21C54 

< 

00000000 

w 

TAR 

#12 

FFF21C4E 

< 

00000000 

u 

TAR 

#11 

FFF21C50 

< 

00080008 

w 

TAR 

#10 

FFF21C4A 

< 

00000000 

u 

TAR 

#9 

FFF21C4C 

< 

00FE00FE 

u 

TAR 

#8 

FFF21C46 

< 

00000000 

w 

TAR 

#7 

FFF21C48 

< 

00030003 

w 

TAR 

#6 

FFF21C42 

< 

00000000 

w 

TAR 

#5 

FFF21C44 

< 

00030003 

w 

TAR 

#4 

FFF21C3E 

< 

00140014 

w 

TAR 

#3 

FFF21C40 

< 

ooocoooc 

w 

TAR 

#2 

FFF21C3A 

< 

00000000 

u 

TAR 

#1 

#0 

FFF21C3C 

BREAK 

< 

00010001 

w 

TAR 


FC 

DS 

sz 

ocs 

TIME 


SD 

01 

00 

0 

1.2638674 

SEC 

SD 

01 

10 

1 

1.2638680 

SEC 

SD 

01 

00 

0 

1.2638688 

SEC 

SD 

01 

10 

1 

1.2638694 

SEC 

SD 

01 

00 

0 

1.2638700 

SEC 

SD 

01 

10 

1 

1.2638707 

SEC 

SD 

01 

00 

0 

1.2638714 

SEC 

SD 

01 

10 

1 

1.2638720 

SEC 

SD 

01 

00 

0 

1.2638728 

SEC 

SD 

01 

10 

1 

1.2638734 

SEC 

SD 

01 

00 

0 

1.2638741 

SEC 

SD 

01 

10 

1 

1.2638748 

SEC 

SD 

01 

00 

0 

1.2638755 

SEC 

SD 

01 

10 

1 

1.2638761 

SEC 

SD 

01 

00 

0 

1.2638768 

SEC 

SD 

01 

10 

1 

1.2638774 

SEC 

SD 

01 

00 

0 

1.2638781 

SEC 

SD 

01 

10 

1 

1.2638788 

SEC 

SD 

01 

00 

0 

1.2638795 

SEC 

SD 

01 

10 

1 

1.2638801 

SEC 


( continued ) 
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DISPLAY RAW TRACE (68020) (cont.) 


MODE 3 DISPLAY 


>DST 

LINE 

ADDRESS 


DATA R/W 


FC 

DS 

sz 

ocs 

TIME 


#20 

FFF21C5E 

< 

FFFB 

u 

TAR 

SD 

01 

00 

0 

0.5001831 

SEC 

#19 

FFF21C60 

< 

0040 

w 

TAR 

SD 

01 

10 

1 

0.5001838 

SEC 

#18 

FFF21C5A 

< 

FFF2 

w 

TAR 

SD 

01 

00 

0 

0.5001844 

SEC 

#17 

FFF21C5C 

< 

0422 

w 

TAR 

SD 

01 

10 

1 

0.5001851 

SEC 

#16 

FFF21C56 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001857 

SEC 

#15 

FFF21C58 

< 

0000 

w 

TAR 

SD 

01 

10 

1 

0.5001863 

SEC 

#14 

FFF21C52 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001870 

SEC 

#13 

FFF21C54 

< 

0000 

w 

TAR 

SD 

01 

10 

1 

0.5001876 

SEC 

#12 

FFF21C4E 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001883 

SEC 

#11 

FFF21C50 

< 

0008 

w 

TAR 

SD 

01 

10 

1 

0.5001889 

SEC 

#10 

FFF21C4A 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001895 

SEC 

#9 

FFF21C4C 

< 

00FE 

w 

TAR 

SD 

01 

10 

1 

0.5001902 

SEC 

#8 

FFF21C46 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001908 

SEC 

#7 

FFF21C48 

< 

0003 

w 

TAR 

SD 

01 

10 

1 

0.5001915 

SEC 

#6 

FFF21C42 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001921 

SEC 

#5 

FFF21C44 

< 

0003 

w 

TAR 

SD 

01 

10 

1 

0.5001927 

SEC 

#4 

FFF21C3E 

< 

0014 

u 

TAR 

SD 

01 

00 

0 

0.5001934 

SEC 

#3 

FFF21C40 

< 

oooc 

w 

TAR 

SD 

01 

10 

1 

0.5001940 

SEC 

#2 

FFF21C3A 

< 

0000 

w 

TAR 

SD 

01 

00 

0 

0.5001947 

SEC 

#1 

#0 

FFF21C3C 

BREAK 

< 

0001 

w 

TAR 

SD 

01 

10 

1 

0.5001953 

SEC 


LINE 


ADDRESS 

DATA 


Line number 0 in the trace buffer 
indicates the last bus cycle prefetched 
or executed before the Emulator went 
into pause mode. The larger the LINE 
number the further back in the history 
of the program you are viewing. You 
can get a good idea of the relationship 
of bus cycles to instructions by 
matching the bus cycle LINE numbers 
in the DRT to the SEQ# in the 
disassembled trace. 


The address displayed is where the bus 
cycle took place, along with the DATA 
written to, or read from, that address. 
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DISPLAY RAW TRACE (68020) (cont.) 


0 and @ are data direction indicators. 
They display whether data was read 
from an address (0 ) or written to an 
address ( 0 ). These same indicators are 
used in the trace disassembly. 

R/W Indicates whether the cycle was a read 

or a write. 

TAR/OVL TAR/OVL indicates whether the access 

was in the target memory area or in the 
Emulator’s overlay memory (see DM 
command to determine what addresses 
are mapped). 

FC Indicates the state of FCO-2. 

DS (68020, Mode 1, 2) Indicates the state of DSACKO and 

DSACK1. 

SZ (68020, Mode 1, 2) Indicates the state of SIZ0 and SIZ1. 

OCS (68020, Mode 1, 2) Indicates whether the OCS signal was 

asserted. 

TIME (68020) Indicates the elapsed time since 

emulation was entered. 
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SEARCH RAW TRACE (68020) 


Command 


Result 


STA <address> 


Search raw trace for address. 
Enter address pattern that looks 
like raw trace. 


ST <data> Search raw trace for data. Enter 

data pattern that looks like raw 
trace. 

STS <status> Search raw trace for status. See 

page 8-17 for the position and 
meaning of the traced status 
bits. 


Comments 


The code only looks for the amount of information appropriate to the 
current trace mode. That is, in trace mode 0 it only looks for a 24 bit 
address pattern since that is all that is traced. 
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SEARCH RAW TRACE (68020) (cont.) 


Examples 


STA 1680 

STA 16XX DC OFF 

STS 50 DC %1111111110001111 

STS 0 DC %1111111110001111 


address 1680 only 
addresses 1600 through 16FF 
all Supervisor Data cycles 
all writes 


The ES 1800 response is to display all occurrences of the matched pattern 
in trace memory in the same format as for DRT (page 5-94). The first line 
is preceded by the raw trace header. If there are more lines than the 
current screen length, the display pauses at the bottom of the screen and 
waits for a key from the user, [return | continues the trace search. Any 
other key aborts the search. 
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DISASSEMBLE TRACE PAGE 


Command 


Result 


DTB Disassemble the previous page 

of trace memory (from current 
trace memory pointer). 

DTF Disassemble the following page 

of trace memory (from the 
current trace memory pointer). 


Comments 


This command is valid only in pause mode. 

A page is defined by the CRT length parameter in the SET menu. Three 
lines are subtracted for header and prompt lines. 

Refer also to the DT command, page 5-103, the DRT command, page 
5-94, and the repeat command, page 5-125. 
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Macros 

A macro defines a list of commands or expressions that are executed with 
one command key word. This allows you to execute repetitive operations 
quickly and easily. 

You can define up to ten macros. They are referred to by the decimal 
numbers #0-9. The ten macros are linked in one buffer with #1 first, 
#2...#9, and #0 last. 

If the lengths of all ten macros exceeds the buffer length of 125 characters, 
the highest numbered macro is truncated. 

EXAMPLE: If macros #1 to #8 are defined and in this process have used 
up all of the space in the buffer, then an attempt to define macro #9 and 
#0 would result in those macros remaining null. Also, if the length of any 
macro from #1 to #7 was increased after filling the buffer, then macro #8 
would be truncated. If the increase was more than the size of macro #8, 
macro #8 would become null and macro #7 would be truncated. 

There are no warnings when truncation or nullification takes place. If a 
number of long macros are defined, execute the MAC command to 
determine if the macros of the highest numbers are still intact. Using the 
general purpose registers in macros will help save the number of characters 
used. 

Macros can be saved in the Emulator EEPROM. Refer to the LD and SAV 
(pages 5-27 and 5-25) commands for information on saving and reloading 
macros. 
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DISPLAY DEFINED MACROS 


Command 

Result 

MAC 

Display all defined macros in 


order 1-9,0 identified by three 


character sequences. 

Examples 


>_1=DR;DIS CS:IP LEM 4; RUN 


>_2=DB; SS:SP LEN lO.-a'Dataptr 


>MAC 


_1=DR;DIS CS:IP LEN 4; RUN 


_2=DB; SS:SP LEN 10;a'Data_ptr 


> 
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DEFINE/EXECUTE MACROS 


Command 


Result 


<0-9>= <com, exp, op> Define the specified macro. 

<0-9> Execute the specified macro. 


Comments 


A space between the underscore and digit, or digit and equals sign causes 
an error. 

There are shorthand notations for two macros: a comma as the first 
character on a line executes macro #1 and a period as the first character on 
a line executes macro #2. 


Examples 


Three macros have been defined. Macros #1 and #2 can be executed 
independently. Macro #3 contains two nested macros (#1 and #2). 

Macros are not expanded when the macro is defined, so the definition of 
macro #3 may change depending upon the content of macros #1 and #2. 

In this example. Macro #2 uses a general purpose register as a counter. 



( continued ) 
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DEFINE/EXECUTE MACROS (cont.) 


Step and disassemble one instruction at a time. 

>_1= DB USP LEN 20;RET;DIS PC LEN 12 

Display the first 20H bytes on the stack, skip a line for readability and 
disassemble the next instructions that will be executed. 

There is no display on the screen and no syntax checking when a macro is 
defined. Errors are only detected when the macro is executed. 

Macro number three is executed. 

> 3 
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CLEAR MACROS 


Command 

Result 

CMC 

Clear all defined macros. 

<0-9>= 

Clear the specified macro. 

Examples 


Clear macro #1. 


>_1 = 


( continued ) 
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The Repeat Operators 

The command repeat feature provides a way to repeat a command line a 
specified number of times, or indefinitely. A repeat is indicated by an 
asterisk ( 0 ) at the beginning of a command line. The asterisk is followed 
by an optional decimal argument to specify the number of times to repeat 
the buffer contents. If the argument is zero, the buffer content is not 
executed. For example: 


>*5STP;DT 
>*5 STP:DT 
>* 5 STP;DT 


In these three equivalent examples, the STP;DT command is repeated five 
times. If the slash key is typed after the above example is input, the entire 
line is repeated, causing five more STP;DT commands to be executed. 

The repeat argument must be specified in decimal, not in hex, or as a 
variable, and there must be a space following the repeat count if the next 
character is a decimal digit. 

When the repeat argument is not specified it is assumed to be 
4,294,967,295 (2^-1). A repeat can always be terminated by executing a 
reset. However, this will also abort emulation if it is in progress, without 
saving the state of the CPU. 

The TST register is used to terminate repeats by setting it to zero with an 
expression in the command line. It is tested just before the command line 
is executed and if it has become zero, the command buffer is not executed 
and the repeat halts. 

To single step and disassemble until a particular address is reached: 


>*STP;DT; TST=PC-$C324 
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If you are waiting for a RAM location to be cleared: 


>*STP;DT;TST=a87020 


You can use the reset character to stop the repeat if the specified test 
conditions are never reached. 

The TST register is set to all l’s at the start of a repeat. This is necessary so 
that the register is in a known state at the start of a repeat loop. 

Repeats can also be terminated by the states of the limit (LIM) and index 
(IDX) registers. Just before execution begins, the values of LIM and IDX 
are compared. If IDX is greater than or equal to LIM, the repeat is 
terminated. The LIM registers is initialized to the number of times the 
loop will execute, which is the decimal loop count you specified in the 
command line. 

IDX is a counter. It starts at zero and is incremented every time the repeat 
loop is executed. You may assign new values to these registers within 
repeat command lines if you wish. 


Examples 


The following examples show some interesting uses of the LIM and IDX 
registers. 

If you need a decimal counter: 


>BAS IDX=#10 
>*3 IDX 
#0 
#1 
#2 


( continued ) 
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Initialize a block of memory to a decrementing count ending in zero, then 
display it. 


>BYM; M $1000 

$001000 $34 

>*4 LIM-IDX-1 

$001001 $C0 


$001002 $BF 


$001003 $00 


$001004 $21 

>M MMP-4 

$001000 $03 

>*4 

$001001 $02 


$001002 $01 


$001003 $00 


$001004 $21 

> 
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REPEAT COMMAND LINE 


Command 


Result 


/ Re-execute the previous 

command line. No IreturnI is 
necessary. 


Comments 


The slash must be the first character on a line to be recognized as the 
repeat character. 


Examples 


This causes the system to single step and disassemble the instruction just 
executed. 


>STP;DT 

>/ 

>/ 

>/ 

>/ 


This causes the system to single step and disassemble memory starting at 
the program counter (PC) location. 


>STP;DIS PC LEN 10 
>/ 


( continued ) 
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Symbols 

Symbol definitions provide the capability to refer to addresses and data 
values using names, rather than numbers. Symbols are 32 bit integer values 
and sections are 32 bit ranges. Symbols and sections are sometimes 
collectively referred to as symbols. 

There is a total of 64K bytes of RAM allocated for symbol definitions. To 
determine approximately how many symbols you can define, take the 
average symbol name length, add six and divide into 64K. (64 x 1024). 

Symbols are not typed within the Emulator, thus all symbols are global. 
This implies that a symbol and a section may not be defined using the same 
name, a symbol name may only be defined once, and section range values 
may not overlap. 

Symbols may be redefined by assigning a new value to the symbol name. If 
you want to reassign a symbol name to a section value, or if you want to 
change the range value of a section, you need to delete the symbol or 
section name before assigning the new value. 

Most compilers and assemblers create symbol tables from the symbols 
defined in your program. These symbols can be easily downloaded if you 
have a linker and converter that can create Extended Tekhex serial data 
records. See the SET command (page 5-3) for the serial data format 
variable. If you are going to download sections that have already been 
defined (perhaps from a previous download of the same file), purge all 
symbols or delete the section definitions from memory before 
downloading. If you do not, an error occurs when you attempt to redefine 
the value of a section and the download will abort. 

Symbols may be used as parameters to any ESL commands. The only 
limitation on symbols is that they cannot be used meaningfully with the 
‘colon’ operator. The single line assembler accepts symbols as address 
references and data values. 

Memory and Trace disassembly display symbol names in place of absolute 
values for address fields. The following examples illustrate the difference 
when the same program is disassembled with and without symbol 
definitions. 
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First, the symbols are defined. 


>SYM 

$00000166 LOOP 
$00003000 I/O port 0 
>SEC 

$00000166 TO $00000160 DEMON.MODULE 


The following example shows memory disassembly with symbol 
definitions. 


SEQ# ADDR OPCODE 

MNEMONIC 

OPERAND 

FIELDS 

BUS CYCLE 

DATA 

SEC: DEMON.MODULE 




0009+LOOP 




0009+000000 31C23000 

MOVE,W 

D2.I/0 PORT 

0 003000<8787 

0008+000004 D081 

ADD.L 

D1,D0 


0007+000006 64000004 

BCC.L 

$000172 


0006 000172 D885 

ADD.L 

D5,D4 


0005 000174 64F0 

BCC.S 

$LOOP 


SEC: DEMON.MODULE 




0004+LOOP 




0004+000000 31C23000 

MOVE.W 

D2,I/0_PORT 

_0 003000<8787 

0003+000004 D081 

ADD.L 

D1,D0 


0002+000006 64000004 

BCC.L 

$000172 


0001 000172 D885 

ADD.L 

D5,D4 


0000 000174 64F0 

BCC.S 

$Loop 
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DISPLAY SYMBOLS 


Command 

Result 

SYM 

Display all defined symbols. 

SYM < value> 

Display all symbols assigned the 


specified value. 

9 <symbol> 

Display the value of the 


specified symbol. 

Examples 


>'sym = 1000 


>'start = 8000 


>'end = 'start +37E 


>SYM 


$00001000 sym 


$00008000 start 


$0000837E end 
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DISPLAY SECTION 


Command 


Result 


SEC 


Display all currently defined 
sections and their values. 


SEC <value> 


Display the section assigned the 
specified value. 


’ <section> Display the value of the 

specified section. 


Examples 


>'sec = 1000 LEN IF 
>Mnit_mod = 'start TO 'end 
>'ram =$0100 TO $0FFF 
>SEC 

$00001000 TO $0000101F sec 
$00008000 TO $0000837E init_mod 
$00000100 TO $0O000FFF RAH 
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SYMBOL DEFINITION 


Command 


Result 


’ <symbol> = <value> 


Assign the <value> to the 
specified symbol. 


Comments 


A space indicates the end of the symbol name. Symbol names can be up to 
64 characters long, but only 16 character names can be uploaded and 
downloaded. 

<symbol> Any combination of ASCII characters with decimal 
values in the range 33-126. This range includes all 
of the printable ASCII characters. 

<value> A 32 bit integer value or a range. 

Be sure to end a symbol name with a space when assigning a value. If a 
space is not entered as the last character of a symbol name, the characters 
that follow will be recognized as a continuation of the symbol. 

Once you type the single quote, the Emulator will display what you type in 
lower case letters unless you explicitly type upper case letters (using the 
shift key). After a space is typed (ending the symbol name) display will 
revert back to all upper case letters. 

If a symbol name is assigned a value that is a range, it is assumed that you 
are defining a section. Section range values cannot overlap. 
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SYMBOL DEFINITION (cont.) 


Examples 

"testing" is recognized as the symbol. 


>'testing =GR0 


"testing=GRO" is recognized as the symbol name. The name will probably 
not be found and you will get an error message. 


>'testing=GRO 


ERROR #77 

UNDEFINED SYMBOL OR CHARACTER DETECTED 


>‘section_X =1000 TO 1FFF 

>'main_loop ='prog_start TO 1 RAM_START - 1 
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DELETE A SYMBOL OR SECTION 


Command 

Result 

DEL ’ <symbol> 

Delete the specified symbol. 

DEL 5 <section> 

Delete the specified section. 

Examples 


>SYM 


$00001000 Sym 


$00008000 start 


>DEL 'Sym; SYM 


$00008000 start 


> 
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DELETE ALL SYMBOLS AND SECTIONS 


Command 


Result 


PUR 


Purge all symbols and section 
references. 


Comments 


Be sure to purge before downloading symbols that may already be defined. 
If you don’t, an error occurs and the download will be aborted. 


>SYM 

$00001000 sym 
$00008000 start 
$0000837E end 
>SEC 

$00001000 TO $0000101F sec 
$00008000 TO $0000837E init_mod 
$00000000 TO $0000FFFF RAM 
>PUR;SYM;SEC 


( continued ) 
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Miscellaneous Commands 
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DISPLAY THE SOFTWARE REVISION DATES 


Command 


Result 


REV Display the software revision 

dates for ESL and the firmware. 


Comments 

This command is valid only in pause mode. 

If you call AMC Customer Service, they will ask you what software 
revisions are in your machine. This command gives you this information. 

Examples 


>REV 

UED AUG 6 08:50:26 POT 1986 - ESL 2.2 
WED AUG 6 16:50:26 PDT 1986 • EMU 3.12 
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DISPLAY A BLANK LINE 


Command 


Result 


RET 


Executes a [return], linefeed. 


Comments 


This command is used to improve readibility when displaying multiple 
lines of data. 


Examples 


Display two blocks of data, separating them with a blank line. 


>DB 0 LEK 

20;RET;DB 

100 

LEN 20 









00000000 

00 

00 

9F 

FE 

00 

00 

01 

00 

00 

00 

01 

AC 

00 

00 

01 

B2 . 

00000010 

00 

00 

01 

B8 

00 

00 

01 

BE 

00 

00 

01 

C4 

00 

00 

01 

CA. 

00000100 

30 

3C 

01 

00 

13 

FC 

00 

FF 

o 

o 

00 

A0 

01 

13 

FC 

00 

FE 0<. 

00000110 

00 

00 

A0 

01 

13 

FC 

00 

FC 

00 

00 

A0 

01 

13 

FC 

00 

F8. 
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Section 6 


TARGET COMMANDS 


Introduction 

The term “run mode” is used to indicate that emulation has begun, that is, 
the microprocessor in the pod is running a program in the target. 
Generally, “target” refers to the hardware and software that you are 
debugging. If there is no target hardware available, the target may be just 
a program, downloaded into overlay memory. The microprocessor in the 
Emulator’s pod replaces the microprocessor in the target. This provides 
the Emulator control of the processor, which in turn provides you with the 
powerful Event Monitor System and the ability to see what is happening 
within the target system. 

The processor in the pod exercises the target in real time. All processor 
functions are available and valid during emulation. 
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Emulation 

STARTING EMULATION 

Entry into emulation or run mode is accomplished by executing any of 
four run commands. Two of the run commands load the reset vectors 
before entering run mode, and two of them enable the breakpoints in the 
Event Monitor. Event system breakpoints may be enabled or disabled 
during run mode. Even if breakpoints are disabled, all other Event 
Monitor System functions are active. 

The reset vectors cannot be loaded during run mode. The following table 
provides a quick reference to the run commands. 



Load 

Break- 


Run 

Reset 

points 

Valid in 

Command 

Vectors 

enabled 

Run mode 

RUN 

NO 

NO 

YES 

RNV 

YES 

NO 

NO 

RBK 

NO 

YES 

YES 

RBV 

YES 

YES 

NO 


Many Emulator commands are valid during run mode. If you are unsure 
whether a command may be entered during run mode, just enter it. An 
error message is displayed if it is not valid. Some commands need to 
communicate with the pod processor, and many of these commands can not 
be entered during run mode, because they require halting of emulation in 
order to complete the command. 
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The following commands may be entered in run mode, but do halt 
emulation briefly in order to read or write data to the target system or 
overlay memory. 


M - Memory Mode 

a - Indirection Operator 

DB - Display Block of Memory 

ASM - In-Line Assembler 

DIS - Memory Disassembler 

NXT - Memory Mode 

LST - Memory Mode 


If there are target hardware problems, it may not be possible to enter run 
mode. In these cases, error messages are displayed describing the problem. 
If the error conditions are not cleared, a reset is required to bring the 
system back into command entry mode. 

HALTING EMULATION 

Emulation can be halted in one of four ways: 

1. Enter the stop emulation command, STP. When this 
command is entered during run mode, emulation is 
stopped and the values of the microprocessor registers are 
loaded into Emulator memory. The current PC and event 
monitor group number are displayed. 

2. The event monitor system can stop emulation if you have 
set up breakpoints and the breakpoints are enabled. 

When a breakpoint condition occurs , emulation is halted, 
the microprocessor registers are uploaded, and the PC and 
event monitor group number are displayed. 

3. You can reset the pod or Emulator. This is done by 
entering a reset command, RST, or the system reset 
character defined in the SET menu. 
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4. Emulation breaks automatically if an access or write 
violation occurs in the target system. An error message 
indicates the condition that caused the error. 

USING REGISTERS IN RUN MODE 

Setting and displaying the microprocessor registers during run mode can 
lead to unexpected results because the Emulator keeps a RAM image of the 
microprocessor registers. This image is downloaded to the processor 
whenever run mode is entered. The image is uploaded from the processor 
when emulation is stopped by the STP command or the Event Monitor 
System. 

Because of this, modifying these registers during run mode simply alters 
the Emulator’s image of the registers. The Emulator does not download 
the new values of the registers to the microprocessor. When emulation is 
broken, the current values of the microprocessor registers are uploaded, 
and the RAM image is overwritten. Thus, you cannot dynamically change 
the value of the microprocessor registers while emulating, and a display 
register command entered after emulation has begun will show you the 
register values upon entry to emulation, not the values the registers 
currently contain. 
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RUN TARGET PROGRAM 


RBK 


RBY 


Command 


Result 


Begins executing the target 
program at the current PC 
memory location. If the run 
with breakpoints is executed 
while already in run mode (after 
a RUN command is entered), 
this will enable breakpoints 
without stopping emulation. 

(68000/08/10) The Emulator 
loads the SSP and PC registers 
with the values located in 
supervisor program space 
addresses $0 and $4 
respectively, initializes the SR 
register to $2700, and starts 
emulation with breakpoints 
enabled. 

(68020) The Emulator loads the 
ISP and PC registers with the 
values located in supervisor 
program space addresses $0 and 
$4 respectively, initializes the 
SR register to $2700, and starts 
emulation with breakpoints 
enabled. 


/ continued ) 
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RUN TARGET PROGRAM (cont.) 


RUN Begins executing the target 

program at the current PC 
memory location. 

RNV (68000/08/10) The Emulator 

loads the SSP and PC registers 
with the values located in 
supervisor program space 
addresses $0 and $4 
respectively, initializes the SR 
register to $2700, and starts 
emulation. 

(68020) The Emulator loads the 
ISP and PC registers with the 
values located in supervisor 
program space addresses $0 and 
$4 respectively, initializes the 
SR register to $2700, and starts 
emulation. 


Comments 

RNV and RBV are valid only in pause mode. 

All defined events are active while RBK and RBV are executing. 

Entering RNV is identical to entering LDV;RUN and entering RBV is the 
same as entering LDV;RBK. 


Examples 


In the following example the Emulator begins running the program at the 
current PC register address and breaks (halts emulation) when AC1 is 
encountered. 
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RUN TARGET PROGRAM (cont.) 


>AC1 = <address>; WHEN AC1 THEN BRK 
>RBK 


In the example below the Emulator begins running the program at the 
current PC register addresses, waits for the breakpoint, then disassembles 
one page. 


>AC1 = <address>;WHEN AC1 THEN BRK 
>RBK;WAIT;DTB 


6-7 







STOP AND STEP TARGET SYSTEM 


Command 

Result 

R>STP 

Stop emulation and return to 
pause mode. 


The screen displays the current 
PC address, the Event Monitor 
System group number, and 
prompt for further instruction. 

>STP 

From pause mode, the STP 
command executes one 
instruction. To receive visual 
feedback, combine this 
command with a display 
command such as STP;DT. 

Examples 



>STP;DR 

>STP;DT 

>STP;DIS PC LEN 4 
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LOAD RESET VECTORS 


Command 


Result 


LDV 


LDY;RUN 


LDV;RBK 


The Emulator loads SSP and PC 
registers with values located in 
supervisor program space 
addresses $0 and $4 respectively 
and initializes the status register 
(SR) to $2700. 

The Emulator loads SSP and PC 
registers with values located in 
supervisor program space 
addresses $0 and $4 
respectively, initializes the 
status register (SR) to $2700, 
and starts emulation with 
breakpoints enabled. 

NOTE: See the RNV command 
for auto entry of this function. 

The Emulator loads SSP and PC 
registers with values located in 
supervisor program space 
addresses $0 and $4 
respectively, initializes the 
status register (SR) to $2700, 
and starts emulation with 
breakpoints enabled. 


( continued) 





LOAD RESET VECTORS (cont.) 


Comments 

This command valid in pause mode only. 

RNV and RBV also load the reset vectors, then enter run mode. 

To verify that the reset vectors are loaded, execute the DR command or 
individually display the PC and SSP (ISP for 68020) registers. 

Refer also to Registers (page 5-68), and the DR command (page 5-76). 


Examples 


Display the registers, then load the reset vectors, clear the address and data 
registers, and verify the changes by redisplaying the register set. 


>DR;LDV;CLR;DR 





- 0 • - 1 - 

- 2 - - 3 - 

- 4 - - 5 - 

- 6 * 

- 7 - 

D = 5D480000 01030000 

78787878 00000000 

17000000 01000000 

00000000 

00000000 

A = 00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 


SR = .SI7 


SFC = 0 

MSP = 

00000000 

CCR = . 

CAAR = 00000000 

DFC = 0 

ISP = 

00009FFE 

PC = 00000190 

CACR = 00000000 

VBR = 00000000 

USP = 

00000000 

- 0 - - 1 - 

- 2 - - 3 - 

- 4 • - 5 - 

- 6 - 

- 7 - 

D = 00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 

00000000 

A = 00000000 00000000 

00000000 00000000 

00000000 00000000 

00000000 


SR = .SI 7 


SFC = 0 

MSP = 

00000000 

CCR = . 

CAAR = 00000000 

DFC = 0 

ISP = 

00009FFE 

PC = 00000100 

> 

CACR = 00000000 

VBR = 00000000 

USP = 

00000000 
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DELAY EXECUTION UNTIL EMULATION BREAK 


Command 


Result 


WAI Delay executing the specified 

command until emulation is 
broken. 


Comments 


Usually this command is used to delay executing a display command until 
an Event Monitor System breakpoint is reached. 

An event may never occur to bring the Emulator out of run mode. When 
this happens, use the reset character to reset the system. 

After a reset, the delayed command is lost from the input buffer. 


Examples 


The Emulator disassembles a page of trace after a breakpoint is reached. 
Entering RBK;DTB without the WAI command, results in an error. The 
error message COMMAND INVALID DURING EMULATION is 
displayed. 


RBK;WAI;DTB 


( continued ) 





DELAY EXECUTION UNTIL EMULATION BREAK (cont.) 


The Emulator runs until an access violation or a write violation is 
encountered, then displays a message pointed at by the A4 register. 

RUN;WAI;DIA A4 
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CYCLE (68010) 


Command 


Result 


CYC 


Causes target system to execute 
a single bus cycle. 


Comments 


When executing the CYC command a bus error is initialized automatically. 
Refer to page 5-72 for a listing of the bus errors. This forced bus error 
will make available the stack register information that simulates bus cycles. 

CYC does not actually execute the target program the way a STP command 
does. The individual cycles are simulated by performing peeks/pokes to 
the target system. The Emulator does enter RUN while executing the bus 
cycles. Trace memory does not keep a record of transactions to and from 
the target systems. 

This command is only operable on the 68010 microprocessors. 
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RESET 


Command 


Result 


RST 


The microprocessor reset pin is 
asserted for 512 clock cycles. 


Comments 


The RST command is not valid during emulation. 

The reset pin on the microprocessor is asserted and affects any hardware 
interfaced to it. 
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Section 6: Target Commands 


Memory Commands 

Memory commands allow you to modify and display memory in a number 
of different ways. “Memory” refers to memory in your target system or 
the Emulator’s overlay memory. If the overlay memory is mapped 
(mapped memory will have the RW, RO or ILG attributes assigned to it), 
read and write accesses are directed to it. Mapped memory is modified by 
a memory command even if it is mapped as read only. If memory is 
unmapped, (memory with the TGT attribute assigned to it), memory 
command accesses are directed to the target system memory. Mapped and 
unmapped memory may be interleaved in any way you desire. See the 
Overlay Memory section (page 5-53) for details. 

The default data length affects most memory commands. There are three 
data lengths to choose from: byte mode, (BYM), word mode (WDM), and 
long word mode (LWM). Commands that accept data parameters truncate 
the data entered to the current default data length. If you enter 
If i n o len 20.23F6I and the default data length is byte mode, the FIN 
command truncates the data field to [f 6] and searchs the range for that byte. 
Commands that display data use the current data length. 

Some memory commands may be executed during run mode. These 
commands halt emulation for a brief time in order to read from or write to 
memory. If memory commands are executed while in the run mode, 
remember that you are not emulating in real-time. 


( continued) 
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The following table shows the commands that can be entered in run mode 
and the commands that are affected by the default data length. 


Command 

Legal in 

Run Mode? 

Uses Default 
Data Length? 

DB 

YES 

YES 

FIN 

NO 

YES 

FIL 

NO 

YES 

BMO 

NO 

NO 

VBL 

NO 

NO 

LOV 

NO 

NO 

VFO 

NO 

NO 

ASM 

YES 

N/A 

DIS 

YES 

N/A 

M 

YES 

YES 

3 

YES 

YES 
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DISPLAY MEMORY BLOCK 


Command Result 


DB <address range> Reads and displays the specified 

address range. 

DB Reads and displays one page of 

memory, starting at the last 
address displayed by any 
previous DB command. On 
power-up, this command 
displays a page of memory from 
address zero. 

DB <address> Reads and displays one page of 

memory, starting at the 
specified address. 

Comments 

The page length is defined by a parameter in the SET menu. When 
displaying a block of data in byte mode, the ASCII representation of each 
byte is also displayed. 

The DB command provides an easy way to page through memory. Enter 
the DB <address> command to start reading memory at the desired 
address. Follow the display of this page of data with the DB command, 
and type a slash [7] ( page 5-125 ). This repeats the DB command to 
increment the address and scroll through memory. 


( continued ) 
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DISPLAY MEMORY BLOCK (cont.) 


If the display is longer than one page, the XON/XOFF characters can be 
used to start and stop scrolling (page 5-3). 

This command affects real time operation when entered in run mode (see 
page 6-15). 

Examples 

Displays $20 words pointed to by DO. 

>WDM; DB DO LEN 40 

Displays a page of values pointed at by the value on top of the user stack 
(see page 4-13 for information on [a] operator). 

>db ausp 


Display block in byte mode, word mode, and long word mode. 


>BYM 










>DB 0 LEN 20 









000000 

80 48 

45 4C 

4C 4F 

80 80 - 2F OF 

FI F9 

5E 2F 

F6 F0 

.HELLO../. 

- A /.. 

000010 

OF 03 

F0 40 

OF 0C 

F0 40 - 07 06 

F0 90 

OF 0C 

D8 00 

...a...a.. 


>WDM 










>DB 0 LEN 30 









000000 

4880 

4C45 

4F4C 

8080 - 0F2F 

F9F1 

2F5E 

F0F6 



000010 

030F 

40F0 

0C0F 

40F0 - 0607 

90F0 

0C0F 

00D8 



000020 

0FFF 

F9FF 

1FFF 

7FFF • 3FFF 

BDFF 

1FFF 

FFFF 



>LWM 










>DB 0 

LEN 30 









000000 

48804C45 

454C8080 0F2FF9F1 

2F5ER0F6 




000010 

030F40F0 

0C0F40F0 060790F0 

OCOFOOD8 




000020 

0FFFF9FF 

IFFF7FFF 3FFFBDFF 

IFFFFFFF 
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FIND MEMORY PATTERN 


Command 


Result 


FIN [.B .W .L] <range>, <data> Search <range> for the data 

pattern. All occurrences of the 
pattern are displayed: 


$<address>=$<data> 

> 


If the pattern is not found 
within the range: 


NOT FOUND 
> 


Comments 


This command is valid in pause mode only. 

Data may be either an integer or don’t care value. Find uses the default 
data length, regardless of the length of the <data>. 


( continued) 
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FIND MEMORY PATTERN (cont.) 


Examples 


To find a bit pattern using don’t cares use either of the following forms: 


>FIN 1000 TO 2FFF, 60XX 
or 

>FIN 2000 LEN 2000,6000 DC OFF 


Find the initialization data in the start module section. 


>FIN 'startjnodule, 1 init_uart 


Find any NOPs in the range. 


>FIN.W 100 TO 1000,4E71 
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FILL OPERATOR 


Command 


Result 


FIL[.B .W .L ]<range>,<constant> Fills <range> with the 

<constant> data pattern. 


Comments 


This command is valid in pause mode only. 

<constant> must be an integer. 

The fill command uses the default data length, regardless of the length of 
<constant>. 

The fill command can be verified using the VBL (verify block) command 
(page 6-22). 


Examples 


Fill RAM with zero to initialize data space. 


>FIL 2000 LEN 50,0 


Fill RAM section with initialization data. 


>FIL RAM, 1 init_data 
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VERIFY BLOCK DATA 


Command 


Result 


VBL <address range>, <data> Verifies that <address range> 

contains the specified data. 

If there are differences: 


$<address> = $XX NOT $YY 


<address> is the address where 
the misverify occurred. “XX” 
is the actual data at the location. 
“YY” is the data specified in 
the command statement. 


Comments 


This command is valid only in pause mode. 

The VBL command uses the default data length, regardless of the length of 
<data>. 

Refer also to the MMS command (page 5-81), and the BMO command 
(page 6-24). 
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VERIFY BLOCK DATA (cont.) 


Examples 


Verify that a range contains $3F. 


>VBL 0 TO 2000,3F 
$00000004 - $00, NOT $3F 
$00000126 - $76, NOT $3F 
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BLOCK MOVE 


Command 


Result 


BMO <range>,<address> Moves <range> to the new 

<address>. The current value 
of MMS specifies the relocation 
register used during the 
transfer. 


BMO <range> 9 <space>,<address> Moves <range> to the new 

< address>. The <space> 
argument specifies the memory 
mode status to use during the 
transfer. 


BMO <range>,<address>,<space> Moves <range> to the new 

<address>. The range is read 
from the space specified in the 
MMS register. The block is 
written to <space>. 


BMO <range> ,< space>, 

<address>,<space> Moves <range> to the new 

<address>. The range is read 
from <space> specified in the 
argument following the range. 
The block is written to <space> 
specified in the argument 
following the address. 
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BLOCK MOVE (cont.) 


Comments 


This command valid in pause mode only. 

The following rules of thumb may make the numerous forms of this 
command less confusing. If there is no space specified for the source 
argument, MMS is always used (page 5-81). If no space is specified for the 
destination address, MMD is always used. 

A non-overlapping block move can be verified using the VBL command. 


Examples 


Move a range to a new location in supervisor data space. 


>MMS=SD 

>BM0 100 TO 500, 1000 
or 

>BMO 100 to 500, SD, 1000 


To move data from range 10 to 20 in supervisor program space to a starting 
address of 30 in supervisor program space: 


MMS = SP 
MMD = SP 

BMO 10 TO 20, 30 


To move data from the range 100 to 200 in supervisor program space to a 
starting address 300 in user data space: 


MMS = SP 
MMD = UD 

BMO 100 TO 200, 300 


( continued ) 
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BLOCK MOVE (cont.) 


The following example moves data without setting the MMS and MMD 
registers. To move data from range 400 to 500 in supervisor data space to a 
starting address of 600 in user data space regardless of what MMS and 
MMD are set to: 
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VERIFY BLOCK MOVE 


Command 


Result 


YBM <range> 9 <address> Verifies move of <range> to the 

new <address>. The current 
value of MMS specifies the 
relocation register used during 
the transfer. 


YBM<range>,<space>,<address> Verifies move of <range> to the 

new <address>. The <space> 
argument specifies the memory 
mode status used during the 
transfer. 


VBM <range>,<address>,<space> Verifies move of <range> to the 

new <address>. The range is 
read from the space specified in 
the MMS register. The block 
was written to <space>. 


VBM <range> 9 <s pace >, 

<address>,<space> Verifies move of <range> to the 

new <address>. The range is 
read from <space> specified in 
the argument following the 
range. The block was written to 
<space> specified in the 
argument following the address. 


( continued ) 
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VERIFY BLOCK MOVE (cont.) 


Comments 

This command is valid only in pause mode. 

Verifies that a non-overlapping block move was successful. 

Examples 

To verify data from range 400 to 500 in supervisor data space with a range 
starting address of 600 in user data space regardless of what MMS and 
MMD are set to: 
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LOAD OVERLAY MEMORY 


Command 


Result 


LOY <range> Moves data from the target 

system memory to the Emulator 
overlay memory in the specified 
address range. 


Comments 


This command is valid only in pause mode. 

Refer to the VFO command, page 5-66, to verify the load overlay 
command. 

To load overlay memory from the target memory, a target system must be 
connected to the ESI800 Emulator and overlay memory installed and 
mapped. 

To load a target memory range into the overlay memory at a different 
address, use the LOV command, then do a block move of the range. 

Refer also to the Overlay Memory section, page 5-53. 


Examples 


To load overlay memory from Target memory $80000 to $87FFF: 


>LOV 80000 LEN 8000 
>LOV 'BOOT RANGE 
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VERIFY OVERLAY MEMORY 


Command 


Result 


VFO <range> Compares <range> in target 

memory to the same range in the 
overlay memory. 

If there are any differences, the 
address and data difference is 
displayed: 


<address> = XX NOT YY 


“XX” is the data present in 
overlay memory. “YY” is the 
data at that location in the target 
system memory. 


Comments 


This command is valid only in pause mode. 

Refer also to the Overlay Memory section, page 5-53. 
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VERIFY OVERLAY MEMORY (cont.) 


Examples 


To verify the two overlay loads in the LOV command section: 


>VFO 80000 LEN 8000 
>VFO 'BOOT RANGE 


( continued ) 
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Line Assembler 

The Motorola 68000 series line assembler allows you to enter and assemble 
Motorola 68000 series mnemonic instructions into target memory. All 
standard Motorola 68000 mnemonics listed in the 16 Bit Microprocessor 
Users Manual or MC68020 32 Bit Microprocessors Users Manual are 
supported. In addition to these instructions many assembler directives are 
supported. 

Parameters: 

■ Not all arithmetic operators are available for assembly. 

The following arithmetic operators are allowed in an 
assembler expression: (|+ - | ). Only 16-bit arithmetic is 
performed. For proper usage refer to the section on 
expressions. 

■ Parentheses are allowed in group algebraic expressions. 

■ Double quotes (0) or a slash sign ([/]) is used to delineate 
ASCII strings. If you enclose the string in double quotes, 
you may not use double quotes in the string, but any 
number of slashes may be used. 

If you enclose the string in slashes, you may not use slashes 
within the string, but any number of double quotes may be 
used. 

■ Capital letters is the default for ASCII text. The use of 
|<backspace>| will allow entry of lower case letters within a 
text string until you enter a |<space>| . 

■ The two number bases are hexadecimal and decimal. 
Decimal is the default. You do not need to enter a @ sign to 
denote decimal numbers. Numbers beginning with $ are 
hexadecimal. All other numbers are decimal. 

■ When referencing memory, you must use a leading zero 
with the program counter relative. 

■ The pound sign @ denotes an immediate addressing mode. 
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Section 6: Target Commands 


Examples 


0 (PC,D3) -PCR with index and displacement. 

0 (A4 # D3) -address register indirect with index and displacement. 
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LINE ASSEMBLER 


Command 


Result 


ASM Assembly begins at the last 

address displayed during a 
previous assembly session. At 
power-up the start address will 
be 0. 


>ASM 

**** 680XX LINE ASSEMBLER **** 
000000 >X 


ASM <arg> 


Assembly begins at the 
specified address. 


>ASM <address> 

**** 680XX LINE ASSEMBLER **** 
000000 >END 


END 

X 


000000 >x 

**** END OF LINE ASSEMBLY **** 


Exit line assembly. 
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LINE ASSEMBLER (cant.) 


Comments 


All 680XX instructions can be entered from the line assembly mode. The 
instructions will be converted to machine code and loaded into memory at 
the address specified in the prompt. 

The following pages describe the supported assembler directives. 
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ASSEMBLER DIRECTIVES 


Command 


Result 


ORG Sets program assembly origin: 



END or X Exits from line assembler to the 

command level: 



DC Defines constant byte, word, 

long word, or text string. 


002400 > DC.W#$8034,256, 1024 
002400 8034 0100 0400 


EQU 


Defines/redefines local symbol 
(L0-L9): 
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ASSEMBLER DIRECTIVES (cont.) 


6590 >L3 EQU $7A44 
6590 > 


or if symbolic debug hardware 
is installed: 


6590 > 'Unit EQU OFDEO 
6590 > 


SET 


L0,L1...L9 


Defines/redefines symbol value 
(only valid with local label LOX 
L9X unless symbolic debug is 
installed). 

Prints value of local symbol: 


756A >L3 

756A >L3 EQU 7A44h 
756A > 


’symbol 


Prints value of symbol. This is 
only valid if symbolic debug 
hardware is installed: 


756A >'Unit 

756A >'Unit EQU FDEOH 

756A > 


( continued ) 
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ASSEMBLER DIRECTIVES (cont.) 



Disassembles one instruction at 
the current address: 
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MEMORY DISASSEMBLER 


Command 


Result 


DIS <range> 


DIS <address> 


DIS 


Disassembles and displays the 
data in the specified range. 


Disassembles one page of 
memory beginning at a 
specified address. 

Disassembles and displayss a 
page of memory beginning at 
the last address display during 
previous DIS command. At 
power-up this value is 0. 


Comments 


You should be familiar with Motorola 68000 assembly language 
programming and have the 16 Bit Microprocessor Users Manual or the 
MC68020 32 bit Microprocessor Users Manual by Motorola. 

The information presented here is an overview and should be used in 
conjunction with Motorola documentation. 


( continued ) 
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MEMORY DISASSEMBLER (cont.) 


A disassembly command with an integer argument or no argument enters a 
special disassembly mode. The disassembly can be continued by typing a 
space or I return I . It is exited by typing any other character. 

A page of data is defined by a parameter in the SET menu. 


<space> 

Continues disassembling 
line at a time. 

|RETURN| 

Continues disassembling 
page at a time. 

any char except <space> or 
|RETURN| 

Exits disassembly mode. 
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Memory Mode 

Memory mode allows you to view and modify memory using a simple 
scrolling scheme. Enter memory mode by executing the M command. The 
current address and associated data are displayed. If the first character 
entered on a memory mode command line is a [return], the next address 
and its data are displayed. If a value is entered before the | return! , that 
value is written to the current address before displaying the next address. 
A list of up to nine values separated by commas may be entered after a 
memory mode prompt. These data are stored to consecutive addresses. 

The scroll direction is determined by two commands, NXT and LST. NXT 
(next) increments the address and LST (last) decrements the address. 
Entering either of these commands during run or pause mode sets the scroll 
direction and enters memory mode. The scroll direction can also be 
changed after you have already entered memory mode by executing the 
appropriate command. The scroll direction can be manually overridden at 
any time by using the period [7) and comma □ keys. A period increments 
the address and a comma decrements it. 

The MMP register (memory mode pointer) is always set to the current 
address being accessed. If memory mode is entered without specifying an 
address, the value in this register specifies the starting address. On power- 
up, MMP is set to zero. 
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ENTER MEMORY MODE 


Command 


Result 


M [.B .W .L] <address> Enters memory mode at 

<address>. The address and the 
data at that address are 
displayed preceding the prompt. 

M [.B .W .L] Enters memory mode at the last 

address examined in a previous 
memory mode session. 

The last address is stored in the 
MMP register (memory mode 
pointer). At power-up, this 
value is zero. 

X Exits memory mode. 


Comments 


Affects real-time operation when entered in run mode (see page 6-15). 

Data displayed in memory mode can be in either byte, word, or long word 
lengths. Set byte mode (BYM), word mode (WDM), or long word mode 
(LWM) before entering memory mode. If you are in word mode and enter 
a byte of data, two bytes of data are written: the byte you entered, and a 
zero. If you are in byte mode and enter a word of data, the value is 
truncated, and only a byte is written. 

The MMP register is modified if you scroll to a new address while in 
memory mode. When you exit memory mode, MMP reflects the last 
address examined. 
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ENTER MEMORY MODE (cont.) 


When a |return| is entered as the first character on a line, the address is 
incremented or decremented and the new address and data are displayed. 
On power-up, the default scroll mode is toward increasing memory 
addresses. To change the scrolling direction use the NXT (forward) and 
LST (backward) commands. These can be entered in memory mode. If 
they are entered in pause mode, the scroll mode is set and memory mode is 
entered at MMP. 

The scroll mode can be overridden by using the period and comma keys. A 
|T| increments the address and a Q decrements the address. 

To modify data at a memory location, enter the data and press [return| . 
The data are written to the current address and the next address and data 
are displayed. 

Data can be entered quickly using a list. A list can contain up to nine 
values separated by commas. See example below. 


Examples 


Set the MMP and use the NXT command to enter memory mode. Change a 
word of data and verify. 


>WDM; MMP=$FF000; NXT 

S0FF000 $1234 

>1122 

$0FF001 $OOFF 

>t 

S0FF000 $1122 

>X 

> 



( continued ) 
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ENTER MEMORY MODE (cont.) 


Assume that address $1000 is the start of a data table and you want to write 
a short program to utilize that data. 

Initialize the data using a list. Then invoke the line assembler using MMP 
as the start address (page 6-34). 


>M 1000 

$001000 $00 

>0,1,2,3,4,5,6,7,8 


$001009 $00 

>X 


1 >ASM MMP 

**** 680XX 

LINE ASSEMBLER **** 


1009 > 


Enter your program here. 

Use 'X' or 'END* to exit 
the Line assembler. 
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EXIT MEMORY MODE 


Command 


Result 


X 


Exits memory mode. 





SCROLLING IN MEMORY MODE 


Command 


Result 


I return | Scrolls through memory 

addresses either one byte (8 bits) 
at a time, one word (16 bits) at a 
time, or one long word (32 bits) 
at a time. See BYT, WRD, 
LWM, page 4-28). 

LST The |return| key now 

decrements addresses in 
memory mode. 

NXT The IreturnI key now 

increments (default mode) 
addresses in memory mode. 

. Increments the address in 

memory mode. 

, Decrements the address in 

memory mode. 


Comments 


The NXT and LST commands may be entered from either pause, run or 
memory mode. If entered from the run or pause mode the IreturnI key is 
set to increment or decrement and memory mode is entered at the current 
value of MMP. 

When a comma or period is entered in the memory mode, this temporarily 
overrides the scrolling direction. 
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MEMORY MODE POINTER 


Command 


Result 


MMP Displays the current value of 

the memory mode pointer. 

MMP = <exp> Assigns the value <exp> to the 

memory mode pointer. 


Comments 


MMP is the last value examined while in memory mode. If you enter 
memory mode without specifing an address, the MMP value is used as the 
entry point. 

The default power-up value of the MMP register is zero. This register 
may be stored in EEPROM. 

The memory mode pointer is modified if you change to a new address after 
entering memory mode. When you exit memory mode, the MMP reflects 
the last address examined. 

As with any register, the MMP can be used as a parameter to another 
command. 


( continued ) 
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MEMORY MODE POINTER (cont.) 


Examples 


Set the MMP and verify. 


>MMP=$12330;MMP 
$00012330 
> 
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Section 6: Target Commands 


Diagnostic Functions 

The diagnostic functions (also called special functions, or SFs) are a group 
of utility routines and special tests. They are valuable for locating address, 
data, status or control line problems. There are two categories: RAM tests 
and scope loops. For a complete list see the SF command (page 6-50.) 

RAM TESTS 

These prewritten tests check that RAM is operating properly. They can be 
run on the target or Emulator overlay memory and may be executed in 
either byte or word mode. Byte or word mode must be specified prior to 
initiating the SF test. 

SF 1 and 3 are modeled after a study by Abraham, Thatte, and Narir 
entitled Efficient Algorithms for Testing Semiconductor Random-Access 
Memories [IEEE Transaction on Computers, vol. c-27, no. 6 June 1978]. 
Refer to this publication for background information on these two 
diagnostics. 

SCOPE LOOPS 

Scope loops are diagnostic routines built into the Emulator firmware for 
use when troubleshooting with an oscilloscope. The uses for these special 
functions range from locating stuck address data, status or control lines, to 
generating signatures using signature analysis equipment. 

The firmware is optimized so that the loops execute at maximum speed. 
This short cycle time allows the hardware engineer to review the timing of 
pertinent signals in the target system without using a storage oscilloscope. 
All of these routines must be terminated by resetting the Emulator. The 
scope loops can be executed in either byte or word mode. 

CUSTOM DIAGNOSTICS 

Special functions 40-49 allow you to execute up to ten user written 
diagnostics. In the event that the above mentioned RAM tests and scope 
loops do not provide the desired test for your equipment, these custom 
diagnostics will allow you to download, debug, and execute diagnostics of 
your own design. You may also read or write to any address or function 
code space in the target system and/or overlay memory with these 
diagnostics. 
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SPECIAL FUNCTIONS LIST 


Command 


Result 


SF Displays list of all available 

RAM tests, scope loops and 
miscellaneous tests. 


Examples 


>SF 

SF 0 # <RANGE><CR> 

SF 1,<RANGE><CR> 

SF 2,<RANGE><CR> 

SF 3,<RANGE><CR> 

SCOPE LOOPS: 

SF 10, <ADDRESS>,<PATTERN><CR> 

SF 11, <ADDRESS>,<DATA><CR> 

SF 12, <ADDRESS>,<PAT 1>,<PAT 2><CR> 
SF 13, <ADDRESS>,<PATTERN><CR> 

SF 14, <ADDRESS>,<DATA><CR> 

SF 15, <RANGE><CR> 

SF 16, <ADDRESS><CR> 

SF 17, <CR> 

MISCELLANEOUS: 

SF 20 <CR> 

SF 40-49 <CR> 

CLK <CR> 

CRC <RANGE> <CR> 


SIMPLE RAM TEST, SINGLE PASS 
COMPLETE RAM TEST, SINGLE PASS 
SIMPLE RAM TEST, LOOPING 
COMPLETE RAM TEST, LOOPING 

READ CONTINUOUSLY FROM ADDRESS 
WRITE CONTINUOUSLY TO ADDRESS 
WRITE ALTERNATE PATTERNS 
WRITE PATTERN, THEN ROTATE 
WRITE DATA, THEN READ 
READ DATA OVER ENTIRE RANGE 
WRITE INCREMENTING COUNT 
GENERATE RESET PULSES 

CRC CHECK OF EMULATOR FIRMWARE 
RUN USER PROGRAMS INTERNAL SPACE 
DISPLAY TARGET CLOCK FREQUENCY 
CALCULATE CRC OF SPECIFIED RANGE 
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SIMPLE RAM TEST, SINGLE PASS 


Command 


Result 


SF 0 , <range> Writes a test pattern to all 

locations within the specified 
range, then reads each location 
to verify the data. The 
following pattern sequence is 
used: 


Sequence 

Pattern 

1 

0000 0000 

2 

0000 0001 

3 

0000 0011 

4 

0000 0111 

5 

0000 1111 

6 

0001 1111 

7 

0011 1111 

8 

0111 1111 

9 

1111 1111 

10 

1111 1110 

11 

1111 1100 

12 

1111 1000 

13 

1111 0000 

14 

1110 0000 

15 

1100 0000 

16 

1000 0000 


( continued) 
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SIMPLE RAM TEST, SINGLE PASS (cont.) 


Comments 

All RAM tests default to WDM. 

This command is valid in pause mode only. 

If a location is read that doesn’t match the test pattern, a failure is 
reported. 

The address, correct data, and faulty data are displayed. 

If no failure is detected, the following prompt is displayed: 

COMPLETE 

This is a single pass test. 
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COMPLETE RAM TEST, SINGLE PASS 


Command 


Result 


SF 1 , <range> Writes, then reads a test pattern 

to all locations in the specified 
range. Refer to Efficient 
Algorithms for Test Semi¬ 
conductor Random-Access 
Memories mentioned in the 
introduction to Diagnostic 
Functions for the test pattern. 


Comments 

All RAM tests default to WDM. 

This command is valid in pause mode only. 

If an error is detected, the associated address, correct data, faulty data, and 
test sequence number are displayed. The sequence number specifies which 
test in the complete list of tests caused the failure. 

This is a single pass test. 

Examples 


MEMORY FAILURE: $00000800=$FFFF, NOT $0000; CODE=$06 
An error is detected. 
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SIMPLE RAM TEST, LOOPING 


Command 


Result 


SF 2, <range> Writes a test pattern to all 

locations in <range>, then reads 
each location to verify the data. 
See SF 0 for test pattern. Each 
time the test is executed, the 
pass count is incremented and 
displayed on the screen. 


Comments 


All RAM tests default to WDM. 

This command is valid in pause mode only. 

If no failure is detected, the pass line is the only line displayed. It is 
continually updated, showing the number of times the test has been 
executed. 


SF 2 , o TO 4 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
PASS COUNT = $XXXX 
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SIMPLE RAM TEST, LOOPING (cont.) 


If a failure is detected, the problem address, correct data, and faulty data 
are displayed on the line after the pass number line and the test continues. 


>SF 2,0 TO 4 
YOU MUST RESET 

MEMORY FAILURE 

PASS # 1 

ME TO TERMINATE THIS FUNCTION 
$00000002=$OQFE, NOT $00FF 

UNTIL RESET 



You must reset the Emulator to terminate this test. 
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COMPLETE RAM TEST, LOOPING 


Command 


Result 


SF 3, <range> Writes a test pattern to all 

locations within <range >, then 
reads each location to verify the 
data. See SF 1 for test reference 
information. 


Comments 


All RAM tests default to WDM. 

This commands is valid in pause mode only. 

During execution, a pass count is maintained and displayed on the screen. 

If no failure is detected, the pass line is the only line. It is continually 
updated, showing the number of times the test has been executed. 


>SF 3, 0 TO 2 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
PASS COUNT = $XXXX 
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COMPLETE RAM TEST, LOOPING (cont.) 


If a failure is detected the associated address, correct data, faulty data, and 
test sequence number are displayed. 


>SF 3, 0 TO 2 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
MEMORY FAILURE: $00000002=$0400, NOT $0000; CODE=$01 
MEMORY FAILURE: $00000000=$0400, NOT $0000; C0DE=$03 
PASS #1 

MEMORY FAILURE: $00000002=$0400, NOT $0000; CODE=$01 
MEMORY FAILURE: $00000000=$0400, NOT $0000; CODE=$03 
PASS #2 


UNTIL RESET 


You must reset the Emulator to terminate this test. 
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PEEKS INTO THE TARGET SYSTEM 


Command 


Result 


SF [.B .W .L] 10<address> Consecutively reads from the 

specified memory address using 
MMS as status space register. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


> SF 10, $FFFF 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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POKES INTO THE TARGET SYSTEM 


Command 


Result 


SF[.B,W.L]11 )<address>,<data> Consecutively writes the user 

defined data pattern to the 
specified memory address using 
MMS as status space register. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF.B 10,$FFFF 
YOU MUST RESET 

ME TO TERMINATE THIS FUNCTION 

The data pattern written to address 10 is: 

(BYM) 

(WDM) 

FF 

FFFF 

FF 

FFFF 

FF 

FFFF 
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WRITE ALTERNATE PATTERNS 


Command 


Result 


SF[.B .W .L] 12 <address >, Consecutively writes the user 

<pattern 1 >, cpattern 2> defined data pattern to the 

specified memory address using 
MMS as status space register 
followed by the complement of 
that data pattern to the same 
address. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF 12 $FF0000,$AA,55 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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WRITE ALTERNATE PATTERNS (cont.) 


The following data pattern is written to address $FF0000. 
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WRITE PATTERN THEN ROTATE 


Command 


Result 


SF [.B .W. L.] 13, <address> 9 Consecutively writes the data 

<pattern> pattern to the specified memory 

address using MMS as status 
space register, rotates the 
pattern 1 bit to the left and 
writes to the same address. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF 13,1000,05 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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WRITE PATTERN THEN ROTATE (cont.) 


The following data pattern is written to address 10: 


05 

OA 

u 

28 

50 

AO 

41 

82 
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WRITE DATA THEN READ 


Command 


Result 


S¥[.Tl.\i/.\j\\4,<address>,<data> Consecutively writes the 

specified data pattern to the 
specified memory address using 
MMS as status space register, 
then reads from that same 
address. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF 14, 100,$FFFF 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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READ DATA OVER AN ENTIRE RANGE 


Command 


Result 


SF [.B .W .L] 15, <range> Consecutively reads from the 

specified memory address range 
using MMS as status space 
register. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF 15, 10 TO 20 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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WRITE INCREMENTING COUNT 


Command 


Result 


SF [.B .W .L] 16, <address> 


Consecutively writes a 
constantly incrementing value 
to the specified memory address 
using MMS as status space 
register. 


Comments 


This command is valid in pause mode only. 

You must reset the Emulator to terminate this test. 


Examples 


>SF 16, 10 $FFFF 

YOU MUST RESET ME TO TERMINATE THIS FUNCTION 
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GENERATE RESET PULSES 


Command 


Result 


SF 17 The Emulator sends continuous 

reset pulses to the target system. 


Comments 


You must reset the Emulator to terminate this test. |ctrl| |~z| is the factory 
default reset. 
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CYCLIC REDUNDANCY CHECK 


Command 


Result 


SF 20 


A CRC is calculated on the 
ESI800 internal PROM that 
contains the Emulator 
firmware. 


Comments 


This commands is valid in pause mode only. 

This is an Emulator self-test. 

If a failure is detected, a CRC error is displayed. 
This is a single pass routine. 
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CUSTOM DIAGNOSTICS 


Command Result 


SF <40-49> Executes custom diagnostic. 


SF 40 

Execute diagnostic at $7000 

SF 41 

Execute diagnostic at $7004 

SF 42 

Execute diagnostic at $7008 

SF 43 

Execute diagnostic at $700C 

SF 44 

Execute diagnostic at $7010 

SF 45 

Execute diagnostic at $7014 

SF 46 

Execute diagnostic at $7018 

SF 47 

Execute diagnostic at $701C 

SF 48 

Execute diagnostic at $7020 

SF 49 

Execute diagnostic at $7024 


Comments 


You may determine that the built-in diagnostics and scope loops do not 
provide the proper test for your equipment; for that reason custom 
diagnostics are provided to allow you to download, debug and execute 
diagnostics of your own design. 

Custom diagnostics can access or modify parameters stored in GDO-7 and 
may also read or write to any function code space in the target system 
and/or overlay memory. Special functions 40-49 provide the means of 
executing up to ten custom diagnostics. 

To make a group of diagnostics, you must first create a table containing up 
to ten long-branches that starts at address 7000 Hex. The BRA.L must be 
present or the diagnostic will not be executed. The BRA.L will vector to 


( continued ) 
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CUSTOM DIAGNOSTICS (cont.) 


the start of the user-written routine. (This routine must be located in 
internal RAM, in the range of 7000-78FF (3K) unless a JMP command 
vectors control to overlay memory that is mapped at an address above 
80000 Hex.) To return control to the emulator, the routine will terminate 
with an RTS instruction. 
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CUSTOM DIAGNOSTICS (cant.) 


PEEKING AND POKING INTO THE TARGET SYSTEM (68010/68020) 

There are four special function codes reserved for the purpose of accessing 
the target and/or overlay from a custom diagnostic. These special function 
codes can be generated by the use of the MOVES instruction. (Refer to the 
Motorola MC68020 32 Bit Microprocessor Users Manual.) The function 
code seen by the target system is not the function code that the MOVES 
instruction generates. Instead, the target function code is picked up from a 
register in the internal memory space. 

The register containing the substitution function code is six bits wide and 
contains two function code values: 

■ The lowest three bits of this register (0-2) are referred to 
as X 

■ The upper three bits (3-5) are referred to as Y 

By storing the proper codes in the SFC and DFC registers, it is possible to 
read from one function code space, controlled by X, and write to another 
function code space, controlled by Y. 

Two of the four special function codes are used to access either overlay 
memory exclusively (OYO) or the target exclusively (TGO). The other two 
codes access the target and also overlay memory, when it is mapped. 

The following table lists three columns that show how the three special 
function codes are used. The left column shows the function code that 
originates at the SFC or DFC register inside the CPU; the middle column 
shows which substitution register is used to generate the space code for the 
target system, and to enable overlay memory; the last column indicates the 
two special function codes that are used to enable the target only (TGO) 
and the overlay only (OVO). 


( continued) 
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CUSTOM DIAGNOSTICS (cont.) 


Use of special function codes: 


Origin 



0 

X 

TGO 

1 

X 


3 

Y 


4 

Y 

ovo 


Note that before a custom diagnostic can peek or poke to the target, the X 
and Y registers must be initialized. In most cases only the X bits need to be 
initialized since typically one function code space is all that’s needed. This 
register is located at address $3F63 in the internal memory space: 


7 

6 

5 

4 

3 

2 

1 

0 

n/c 

n/c 

Y2 

Y1 

YO 

X2 

XI 

xo 


Bits 6 and 7 are not used. Data stored to this register can also be read, so 
read/modify/write instructions like AND and OR will work. 

After the X and Y registers are initialized the SFC and DFC registers can 
be loaded. These registers would typically both be loaded with a $1 to 
cause the X register to be substituted, and to enable both the target system 
and the overlay memory when it is mapped. 
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CUSTOM DIAGNOSTICS (cont.) 


PEEKING AND POKING INTO THE TARGET SYSTEM (68000/68008) 

Unlike the 68010, the 68000 and 68008 processors do not support the 
MOVES instruction. Consequently, the 68000/08 Emulators access the 
target differently. 

When the 68000/08 Emulator is not in emulation, the function code seen 
by the target is in a register in the internal memory space. 

The register containing the substitution function code is six bits wide and 
contains the following: 

■ The lowest three bits (0-2) are referred to as X. 

■ Bit 3 is referred to as OVO (overlay only). 

■ Bit 4 is referred to as TGO (target only). 

■ Bit 5 is not used. 

In order to read and write to different function code spaces, X must 
contain the function code space before accessing the target. 

Normally during a peek or poke, if the space to be accessed is overlaid, the 
target and overlay memory are accessed simultaneously. However, if 
accesses to that space in the target cause a bus error, you may set the OVO 
bit and only the overlay will be accessed. Likewise, to restrict accesses to 
the target only, set the TGO bit. 

To access the target (or overlay memory, if it mapped), the diagnostic 
program must generate a function code 1 (user data) during a target read or 
write. Then the function code in the substitution register (located at $3F63 
in the internal memory space) will be seen by the target. 


/ continued ) 
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CUSTOM DIAGNOSTICS (cont.) 


7 

6 

5 

4 

3 

2 

1 

0 

n/c 

n/c 

n/c 

TGO 

ovo 

X2 

XI 

XO 


Bits 5, 6 and 7 are not used. Data stored to this register can also be read, so 
read/modify/write instructions like AND and OR will work. 
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CUSTOM DIAGNOSTICS (cont.) 


DOWNLOAD CUSTOM DIAGNOSTICS 

A user written diagnostic assembled on a host system may be downloaded 
to the Emulator internal RAM. 

The diagnostics to be downloaded must be assembled first. 

The introspective mode software switch setting must be enabled (ON IM ) 
before executing a download sequence. 

After enabling the IM switch the Emulator is considered a target system 
and the DNL command (page 5-38) may be used in its typical manner for 
downloading to a target system. 

Custom diagnostics will not access your target system when in the 
introspective mode. 

To terminate the download process, set the introspective mode software 
switch to off (OFF IM). The Emulator is taken out of introspective mode 
and no longer is considered a target system. 

The system reset character ( |ctrl| [z!) will also take the Emulator out of the 
introspective mode. (|ctrl| [z!) is the system default reset character, and 
SET parameter #2 is the user defined reset character (see page 5-3). 

The emulator has 3K of memory space allocated for custom diagnostics. If 
this is not sufficient then overlay memory may be used for additional 
space. To set up overlay memory for custom diagnostics: 

■ Map overlay memory only above $8000. 

■ Map into a space that is not already used by the target 
system. This will assure that mapping is not done on top of 
already mapped space. 

■ Map as read-only. This will prevent overlay memory from 
being modified by a custom diagnostic. 

■ The OVS (page 5-67) must be set to a non-zero value. This 
will cause overlay memory to provide a DTACK (DSACK 
for the 68020) to the microprocessor. 


( continued ) 
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CUSTOM DIAGNOSTICS (cont.) 


PASSING PARAMETERS TO CUSTOM DIAGNOSTICS 

Many times when writing diagnostics it may be necessary to pass 
parameters to those routines. The SF 40-49 commands do not take 
parameters, so you should store the parameters into one of the eight 
general range registers (GR0-7) or into one of the eight general data 
registers (GDO-7). Your custom diagnostic may then pick up the data or 
store results at the following locations: 


68000/08/10 



BEGINNING RANGE 

ENDING 

RANGE 

GR0 

$3100 - $3103 

$3104 

- $3107 

GR1 

$3108 - $310B 

$310C 

- $31 OF 

GR2 

$3110 - $3113 

$3114 

- $3117 

GR3 

$3118 - $31IB 

$311C 

- $31 IF 

GR4 

$3120 - $3123 

$3124 

- $3127 

GR5 

$3128 - $312B 

$312C 

- S312F 

GR6 

$3130 - $3133 

$3134 

- $3137 

GR7 

$3138 - $313B 

$313C 

- $313F 

68020 

ONLY 



GR0 

$3200 - $3203 

$3204 

- $3207 

GR1 

$3208 - $320B 

$320C 

- $320F 

GR2 

$3210 - $3213 

$3214 

- $3217 

GR3 

$3218 - $321B 

$321C 

- $321F 

GR4 

$3220 - $3223 

$3224 

- $3227 

GR5 

$3228 - $322B 

$322C 

- $322F 

GR6 

$3230 - $3233 

$3234 

- $3237 

GR7 

$3238 - $323B 

$323C 

- $323F 
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CUSTOM DIAGNOSTICS (cont.) 


68000/08/10 



DATA 


DON'T CARE DATA 

GD0 

$3140 

- $3143 

$3144 - $3147 

GDI 

$3148 

- $314B 

$314C - $314F 

GD2 

$3150 

- $3153 

$3154 - $3157 

GD3 

$3158 

- $315B 

$315C - $315F 

GD4 

$3160 

- $3163 

$3164 - $3167 

GD5 

$3168 

- $316B 

$316C - $316F 

GD6 

$3170 

- $3173 

$3174 - $3177 

GD7 

$3178 

- $317B 

$317C - $317F 


68020 

ONLY 



DATA 

DON'T CARE DATA 

GD0 

$3240 - $3243 

$3244 ■ $3247 

GDI 

$3248 - $324B 

$324C - $324F 

GD2 

$3250 - $3253 

$3254 - $3257 

GD3 

$3258 - $325B 

$325C - $325F 

GD4 

$3260 - $3263 

$3264 - $3267 

GD5 

$3268 - $326B 

$326C - $326F 

GD6 

$3270 - $3273 

$3274 - $3277 

GD7 

$3278 - $327B 

$327C - $327F 

GR registers are 32 bits wide while ranges are only valid for the 24 bits. A 
custom diagnostic that required a range parameter and a don’t care and 
returned a 32-bit data parameter might look like: 

>GR4= 

$1000 LEN $40;GD4=$CXFF;SF 

$44;GD0 


The range parameter goes into GR4; the Don’t Care bit (X) goes into GD4; 
then the user diagnostic is called; and finally, the result is displayed as the 
content of the register GD0. 


( continued ) 
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CUSTOM DIAGNOSTICS (cant.) 


DEBUGGING CUSTOM DIAGNOSTICS 

A custom diagnostic may be set up to be debugged similar to debugging a 
program in target memory space. 

After a custom diagnostic is downloaded to the Emulator internal RAM it 
may be debugged by the following procedures: 

■ Enable introspective mode with the IM software switch, 
page 5-21. 

■ Set the SSP register to point to an area of memory that will 
provide a stack. This stack should be the top of the user 
RAM area (7C00 hex) in overlay memory that is mapped as 
read/write. 

If a RTS is encountered while single stepping through a routine the PC 
register will be undefined. 
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READ TARGET SYSTEM CLOCK 


Command 


Result 


CLK Reads the target system clock 

and displays the value in KHz, 
accurate to 1-2 KHz. 


Examples 


>CLK 

CLOCK FREQUENCY = #2001 KHZ 
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TARGET CYCLIC REDUNDANCY CHECK 


Command 


Result 


CRC <range> The system calculates a cyclic 

redundancy check on all 
addresses in <range>. 


Comments 


These commands are valid in pause mode only. 

The CRC command generates a cyclic redundancy check value over a user 
defined address range. Only the byte mode is used for this test. 

CRC calculations can be used to determine if RAM based data is being 
corrupted. Do a CRC over the data base and save the value. Then run your 
program and do the CRC over the range again. If the values do not match, 
data are being corrupted. The Event Monitor System can be setup to catch 
writes to the data base. 

The CRC algorithm is based on the polynomial X^+X^+X^+l. 
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DISPLAY STATUS OF SEVERAL STATUS LINES 


Command 


Result 


BUS Displays the bus status. 


Comments 


Your console will display bus status: 


HLT 

Halt 

IPL 

Interrupt Priority Level 

RST 

Reset 

YCC 

Power 

BER 

Bus Error 


Examples 


The system default status is: 


HLT 

IPL 

RST 

VCC 

BER 

0 


0 

0 

0 


0 indicates an inactive condition. 1 indicates an active condition. 0-7 in 
the IPL column represents the interrupt priority level encoded on the IPL 
lines. 
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Section 7 


68000/08/10 EVENT MONITOR SYSTEM 


Overview 

The ESI800 Event Monitor System (EMS) provides extremely flexible 
system and breakpoint control, enabling the user to isolate or break on any 
predefined series of events and then perform various actions. The user 
controls and monitors the target by entering commands that define events 
as logical combinations of address, data, status, count limit, and optional 
logic state probe inputs. When an event is detected, the ESI800 can break 
emulation, trace specific sequences, count events, execute user supplied 
target routines, and trigger a TTL output. 

The ESI800 Event Monitor System is based on a 16 bit environment. The 
68020 microprocessor consists of a 32 bit architecture. To incorporate the 
68020 into the ESI800 chassis, some enhancements were introduced into 
the emulator’s operating system to facilitate selective tracing. 68020 
tracing requirements are described in Chapter 8. 

WHEN/THEN control statements define events and their corresponding 
actions. There can be several actions for any event. The system only 
recognizes the first three letters of any word in a control statement (e.g., 
WHEN=WHE; THEN=THE). There can be many control statements in 
effect at any time. The Event Monitor System can also switch groups to 
allow for sequencing events. There are four event groups available and the 
control statements and comparator values for any group are independent of 
those in other groups. 
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Event Monitor System control statements can be entered while in run 
mode. The event comparator values can also be modified during run 
mode. However, these new statements and values will not go into effect 
until you stop and restart run mode. 

The ESI800 Event Monitor System monitors target information at the bus 
cycle level; i.e., every read or write cycle that the microprocessor executes. 
The EMS system detects every signal that can affect the target system. It 
can also monitor inputs from the logic state analyzer probe. 

The Event Monitor System essentially takes a picture of the Motorola 
680XX microprocessor’s signals at the end of every bus cycle (refer to 
Motorola manual, 16 Bit Microprocessor Users Manual). The information 
that is recorded into trace memory is the same information that the EMS is 
monitoring. 

The Event Monitor System will only break on the address information that 
was traced. The breakpoint comparators only look at the addresses output 
by the microprocessor. 

The basic Event Monitoring System control statement is of the form: 

[Group] WHE[N] <event> THE[/V] <action> 

Notice that the ESL command processor needs only the first three letters of 
the symbol. 

COMPARATOR REGISTERS 

An event is based on the value of a comparator register or a combination of 
comparator registers. Comparators can be combined with AND, OR, or 
NOT operators. The action that follows an event may be a single command 
or multiple commands separated by commas. 

There are eight comparator registers for each of the four event groups. 
These event registers are listed in the table on the following page. The 
address comparators are used to detect discrete addresses or addresses 
inside or outside a specified range. The data comparators can detect 
specific data patterns and can ignore specified bit positions. The status 
comparators monitor all of the status signals from the microprocessor as 
well as some generated by the ESI800. The status comparators can also 
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Section 7: 68000/08/10 Event Monitor System 


ignore bit positions. The count limit register can be used to detect when an 
event has occurred more than a specified number of times. The logic state 
analyzer register can detect bit patterns in the inputs from the logic state 
probe. 

The following table describes the available event comparator registers. 


Register 

Size 

Description 

Type i 

C bits) 

Address 1 

Range,Integer 

24 

Address 2 

Range,Integer 

24 

Data 1 

Don't Care,Integer 

16 

Data 2 

Don't Care,Integer 

16 

Status 1 

Don't Care,Integer 

16 

Status 2 

Don't Care,Integer 

16 

LSA 

Don't Care,Integer 

16 

Count 

Integer 

16 


Name by Group 


1 

2 

3 

4 

AC1 or AC1.1 
AC2 or AC2.1 

AC1 .2 
AC2.2 

AC1.3 

AC2.3 

AC1.4 
AC2.4 

DC1 or DC1.1 
DC2 or DC2.1 

DC1.2 

DC2.2 

DC1.3 

DC2.3 

DC1.4 

DC2.4 

51 or SI -1 

52 or S2.1 

51.2 

52.2 

51.3 

52.3 

51.4 

52.4 

LSA or LSA.1 

LSA. 2 

LSA. 3 

LSA.4 

CL or CL.1 

CL.2 

CL.3 

CL.4 


ADDRESS COMPARATORS 

Address comparators may be assigned integer values or range values. 
Ranges may be either internal (IRA) or external (XRA). If a range is 
specified without IRA or XRA operators, the default range type will be 
IRA. The following are examples of valid address comparator 
assignments. 
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>AC1=2000 

>AC2=1000 LEN 20 

>AC2.2=XRA 1100 TO 1250 

>AC1.4 = IRA $FF006 LEN $FF 

>AC1.1 = Al 

>AC2='Symbol 

>AC1 =PC + 200 

>AC1.2 = !AC1.4 


DATA AND LSA COMPARATORS 

The data comparators monitor the data bus for specified patterns. The 
LSA comparators monitor the input pulses from the logic state probe. 

Data and LSA comparators may be assigned integer values or don’t care 
values. Don’t care values may be assigned in two ways. The first is to 
specify the value followed by the don’t care mask; the second is to specify 
the value using [x] in the don’t care positions. The following are examples 
of valid data and LSA comparator assignments. 


>DC1=237F 

>LSA=5300 DC $FF 

>LSA.3 = 53XX 

>LSA = %110101 DC $FF00 

>DC2.2 = 42 DC %101 

>DC2 = GD0 + $F 

>DC1.4 = 3'data table + 56 


STATUS COMPARATORS 

The status comparators are assigned values from the list of status constants. 
Many of these constants can be combined to specify a complex comparator 
value. The list on the next page shows the available mnemonics. Any of 
these statuses can cause events. 
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STATUS MNEMONICS 


BER 

bus error 

VM 

valid memory address 

VP 

valid peripheral address 

IP(0-7) 

interrupt levels 0-7 

SP 

supervisor program 

SD 

supervisor data 

UP 

user program 

CPU 

CPU space 

SC(0-7)* 

numeric names for all 8 space codes* 

TAR 

target system access 

OVL 

overlay memory access 

RD 

read access 

UR 

write access 

BYT 

byte access 

WRD 

word access 

*SCO, SC3, SC4, 

used only by 68010 and 68020. 


The status mnemonic table shows which status values can be assigned to 
the comparators. You may assign a status comparator a single mnemonic, 
or you may combine a mnemonic from each of the columns 2-9. 
Mnemonics are combined using an addition operator (0 ) as a Boolean 
AND. 
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STATUS MNEMONIC 

TABLE 


1 

2 

3 

4 

5 6 

7 8 

9 

SI 

= BYT 

+ RD + 

TAR 

+ SCO + BER 

+ IPO + VM 

+ VP 

S2 

URD 

UR 

OVL 

SCl/UD 

IP1 






SC2/UP 

IP2 






SC3 

IP3 






SC4 

IP4 






SC5/SD 

IP5 






SC6/SP 

IP6 






SC7/CPU 

IP7 



Some examples of status comparator assignments: 


>S1=BYT 

>S2=IP7+SD 

>S1.2=0VL+BER 


In the following example, all bits except bit 1 (one) have been masked. 


si = RD 
si 

$00000002 DC $0000FFFD 


In the next example, all bits except bits 1, 2, 9, 10 and 11 are masked. 
These bits are enabled (Is or 0s) and should be considered. 


si = IP7 + RD + TAR 
$00000E06 DC 0000FIF9 
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STATUS COMPARATOR BREAKDOWN 


14 13 12 

11 10 

9 8 7 

6 5 4 3 2 1 

1 1 1 

\ 1 

/ 1 

\ 1 / II 

1=VM 1=VP 

0=IP0 

1=BER 

0=SC0 0=OVL I 


1=IP1 


1=SC1/UD 1=TAR j 


2=IP2 


2=SC2/UP 0=WR 


3=IP3 


3=SC3 1=RD 


4=IP4 


4=SC4 i 


5=IP5 


5=SC5/SD 


6=IP6 


6=SC6/SP 


7=IP7 


7=SC7/CPU 


STATUS 

COMPARATOR 

BIT REPRESENTATION 


VM=00004000 DC BFFF 
VP=00002000 DC DFFF 
1P0=00000000 DC FF1F 
I PI=00000200 DC FIFF 
IP2=00000400 DC FlFF 
IP3=00000600 DC FIFF 
IP4=00000800 DC F1FF 
IP5=OOOOOAOO DC FlFF 
IP6=00000C00 DC FlFF 
IP7=OOOOOEOO DC FlFF 
BER=00000100 DC FEFF 
SC0=00000000 DC FF8F 
SC1/UD=00000010 DC FF8F 
SC2/UP=00000020 DC FF8F 
SC3=00000030 DC FF8F 
SC4=00000040 DC FF8F 
SC5/SD=00000050 DC FF8F 
SC6/SP=00000060 DC FF8F 
SC7/CPU=00000070 DC FF8F 
TAR=00000004 DC FFFB 
OVL=00000000 DC FFFB 
RD=00000002 DC FFFD 
WR=00000000 DC FFFD 
BYT=00000001 DC FFFE 
WRD=00000000 DC FFFE 


When you display the value of the status comparators, you will see don’t 
care values rather than the mnemonics you originally assigned. The status 
comparator breakdown table is provided to aid you in decoding the 
numbers back into mnemonics. 
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The don’t care mask is the value to the right of DC. A zero in a mask bit 
position enables the status bit in the same position on the left side of the 
DC, and “1” in a mask bit position masks or disables the corresponding bit 
on the left side of the DC. 

Determine which bit positions are unmasked (those containing 0s in the 
mask value). It may be easier to do this by setting the status comparator’s 
display base to binary (Ibas si = 2| ). Then refer to the status comparator 
breakdown table and find the unmasked bit positions. Look at the value 
contained on the left side of the DC and match it with the corresponding 
value shown underneath the bit position in the table. 


>si 

$00000E06 DC 0000F1F9 


All bits except bits 1, 2, 9, 10 and 11 are masked. Bits 9, 10, and 11 are 
enabled and a 7 in these three bits of the status value indicates IP7 was 
entered. 

Bit 1 is enabled and there is a 1 in bit 1. So RD was entered. 

Bit 2 is enabled and there is a 1 in bit 2 of the status value so TAR was 
entered. 

Therefore, the original input was: 


>S1=IP7+RD+TAR 


COUNT LIMIT COMPARATOR 

The count limit comparator CL, is used to detect when events have 
occurred a certain number of times. The CL value for group 1 is loaded 
into a hardware counter which is decremented whenever the action CNT is 
executed (see the sections on Defining Events and Action Lists). If a group 
switch occurs, the hardware counter can be loaded with the new group’s 
count limit by executing the RCT (reset count) action. Otherwise, the 
hardware counter will not change its limit value when switching groups. 
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Defining Events 

The Event Monitor System is arranged in four independent groups. These 
groups provide a state-machine capability for debugging difficult 
problems. EMS control statements are associated with one of the four 
groups. If no group numbers are mentioned in the EMS control statement, 
the statement will be assigned to group 1. There are two ways to override 
this default selection of group 1. You can begin the EMS control statement 
with a group number, or you can add a group number to any one of the 
event comparator names. For example: |3 when aci then brk| is functionally 
the same as [when aci.3 then brk[ . You cannot mix group numbers within a 
single EMS control statement. 

EVENT 

You can define an event to be some combination of address, data, status, 
count and logic state probe conditions. Numerous Event Monitor System 
control statements can be entered and will all be in effect simultaneously. 
Conflicting statements may cause unpredictable action processing. 
Parentheses are not allowed in event specifications. 

The NOT operator is used to reverse the sense of the comparator output. 
NOT has higher precedence than either of the conjunctives. 

I when aci and not pci then brk] means break whenever any data pattern other 
than that in DC1 occurs on the bus along with ACI. 

AND and OR can be used where needed to form more restrictive event 
definitions. AND terms have higher precedence than OR terms. 

Iac 1 and pci or DC2| is the same as |aci and dcT| in one statement and |dc2| in 
another. If you are looking for two different data values at an address, use 

1 AC 1 AND PCI OR ACI AND PC2| . 

The OR operator is evaluated left to right and is useful for simple 
comparator combinations. For complex event specifications, OR 
combinations can be replaced with separate EMS control statements for 
clarity. |aci and si or ac2 and S2[ is the same as |aci and sT| and [ac2 and s2] . 
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Defining Action Lists 

The action list in a WHEN/THEN statement defines what the Emulator 
does when an event is detected. Actions are specified in an action list 
separated by commas. The action list may have one or more actions 
defined. 


Examples 


<group> WHEN <event> THEN <action>,<action >,... ,<action> 
The following table lists all possible actions. 


Event Monitor System Actions 


Action 

Description 

BRK 

Break emulation 

CNT 

Count Bus Cycle 

FSI 

Force Special Interrupt 

GRO n 

Change Event Group 

RCT 

Load Count Value 

TGR 

Output Trigger Signal 

TOC 

Toggle Count State 

TOT 

Toggle Trace State 

TRC 

Trace Bus Cycle 


The TRC and TOT actions are described in the Tracing Events section. 
The CNT, RCT, and TOC actions are described in the Counting Events 
section. The ESI action is described in the Special Interrupt section. The 
GRO action is described in the Changing Event Groups section. The TGR 
action is described in the Trigger Signal section. The BRK is described in 
the Breaking Emulation section. 
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The EMS will always resolve conflicting EMS control statements. The 
TOC action in the first statement will be changed to CNT. 


>WHEN AC1 THEN TOC 
>WHEN AC1 THEN CNT 
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DISPLAY EVENT SPECIFICATIONS 


Command 


Result 


DES Displays all of the 

WHEN/THEN statements 
currently active from all groups. 

DES < group number > Displays all of the 

WHEN/THEN statements and 
the comparator values for the 
specified group. 
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DISPLAY EVENT SPECIFICATIONS (cont.) 


Examples 


Display the statements and comparators for groups 1 and 2. 


>DES 1;DES 2 

1 WHEN AC1 THEN BRK 
AC1.1 = $007632 
AC2.1 = $000000 
DC1.1 = $0000 
DC2.1 = $0000 

51 .1 = $0000 

52 .1 = $0000 

LSA.1 = $0000 
CL .1 = $0000 

2 WHEN SI AND DCl THEN CNT,TRC 
2 WHEN CL THEN BRK 

AC1.2 = $000000 
AC2.2 = $000000 
DCl.2 = $40FF DC $00FF 
DC2.2 = $0000 

51 .2 = $0003 DC $FFFC 

52 .2 = $0000 
LSA.2 = $0000 
CL .2 = $0010 
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CLEAR WHEN/THEN STATEMENTS 


Command 


Result 


CES 


Clears all of the WHEN/THEN 
statements currently active. 


CES <group number> Clears all of the WHEN/THEN 

statements for the specified 
group. 


Comments 


The comparator values are not affected by the CES command. 
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Breaking Emulation 

The BRK action stops emulation, returning the system to pause mode. 
When a break event is detected and emulation has been broken, the current 
PC and event group is displayed on the terminal. Emulation begins at the 
values displayed if the registers are not altered and you run or step 
following a break. When entering emulation, the Event Monitor System 
always begins looking for events specified in group 1. 

Breakpoints stop program execution at specific times. After a break you 
can disassemble the trace memory, look at the LSA bits in the raw trace, 
check the CPU register values, or begin stepping through your code. 

Breakpoint actions may be enabled or disabled by selecting the appropriate 
run commands. If you enter emulation with the RBK or RBV run 
commands, breakpoints are enabled. If you enter emulation with the RUN 
or RNV commands, breakpoints are disabled, even if there are event 
statements specifying the BRK action. If emulation is entered with 
breakpoints disabled, you can enable them while running by entering the 
RBK command. If you enter emulation with breakpoints enabled, you can 
disable them while running by entering the RUN command. The RNV and 
RBV commands are not allowed during emulation. These commands load 
the reset vectors, which cannot be done during emulation. 

Emulation may be halted using the STP command. The reset character 
(Default is |ctrl[ |z1. May be changed through the Set command, option 2) 
also breaks emulation. 


Examples 


Break when address $3000 is accessed. 


>AC1=3000 

>WHEN AC1 THEN BRK 
>RBK 
R> 


( continued ) 
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Trace only accesses between 1000 and 113C. Break after ten accesses to 
this address range. 


>AC1=1000 to 113C 
>CL =#10 

>WHEN AC1 THEN CNT.TRC 
>WHEN CL THEN BRK 
>RBV 
R> 


Break when 55AA is written to port A. 


>AC1='P0RT_A 

>DC1=55AA 

>S1=UR 

>WHEN AC1 AND DC1 AND SI THEN BRK 
>RBK 
R> 


The 68008 uses an 8 bit data field. The emulator traces this information in 
a 16 bit field where the high and low positions are dependent on it being an 
even or odd address. 

To break on an 8 bit data field use the following example: 


DC1 = 55XX 
DC2 = 0XX55 

WHEN DC1 OR DC2 THEN BRK 
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Tracing Events 


Events: 

TRC 

TOT 


The Event Monitor System can be set up to trace bus cycles selectively. If 
all of the conditions specified in the event portion of the WHEN/THEN 
clause are satisfied, the trace action, TRC, causes the specified bus cycle to 
be recorded into the trace memory. 

The toggle trace, TOT, provides a way to turn tracing on and off. When a 
TOT event is detected, the trace is toggled to the opposite state, either on 
or off. You can specify a single event that starts and stops trace each time 
it is detected or specify any number of events that toggle trace on and off. 

If there are no event actions that specify TRC or TOT, all bus cycles are 
traced. If there is a TRC event, only qualified bus cycles are traced. If 
there is a TOT event, trace will be off until the TOT is detected, then all 
bus cycles are traced until encountering another TOT event. 


( continued ) 
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This table describes the trace conditions immediately before and 
immediately after a group change. 


Previous 

Group 

ii 

|| Nothing 
j| Specified 

New Group 

i i 

i i 

i trc i 

TOT 

i 

i 

i 

Nothing 

| | Trace 

j Trace only | 

Trace nothing 

i 

Specified 

jj all eyeles 

| qual'd cycles | 

until first TOT 

i 

TRC 

|| Trace 

| Trace only | 

Trace nothing 

i 


|| all eyeles 

| qual'd cycles | 

until first TOT 

i 

TOT 

| | T race 

| Trace only | 

Trace nothing 

i 

(Not tracing) 

|| all eyeles 

| qual'd cycles | 

until first TOT 

i 

TOT 

|| Trace 

| Trace only | 

Trace nothing 

i 

(Tracing) 

|| all eyeles 

.ii. 

j qual'd cycles j 

i _ _i 

until first TOT 

. i 

| II 111 | 


This table describes initial trace conditions. 


Action 

ii 

Trace 

Specified 

n 

-ii- 

Condition 

Nothing 


Trace 


HI 

all eyeles 

TRC 

11 
n 

Trace only 


ii 

Qua I'd TRC events 

TOT 

ii 

Trace nothing 


ii 

until TOT event 
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Examples 


Trace only a specific subroutine. Break at the end of the routine. 


>ACl='Sub_start to 'Subend 
>AC2= 1 Subend 
>WHEN AC1 THEN TRC 
>WHEN AC2 THEN BRK 
>RBK 
R> 


The WHEN LSA THEN TOT command statement is used to turn on a trace 
when a specific hardware event occurs and turn off when the activity is 
terminated. 

Two event groups are required to specify special on and off points. 

1. Identify the logical state analyzer addresses: 


LSA.1 = $0000 DC $FFFE 
LSA.2 = $0001 DC $FFFE 


This sets up the LSA comparator to a specific address. 

2. To set up a WHEN/THEN statement to monitor a specific 
activity outside the microprocessor: 


WHEN LSA THEN TOT, GRO 2 
WHEN LSA.2 THEN BRK 


The system waits for the logic state analyzer bit 0 to go 
low and then uses the toggle trace command (TOT) to 
turn on trace memory and group 2 to switch groups. In 
group 2 all bus cycles are traced until LSA pod bit 0 goes 
high. Then, emulation is broken. 


( continued ) 
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Counting Events 

Registers: 

Value Type - 16 bit integer 

CL 


CL.1 


CL.2 


CL.3 


CL.4 


CL=<EXP> 

CL<.group>=<EXP> 


Events: 


CNT 


RCT 


TOC 



Events can be defined to count bus cycles selectively. There is one 
hardware counter and there are four count registers, one register for each 
group. Each group has its own count limit register (CL). The Event 
Monitor System has only one counter. The hardware counter is 
automatically loaded with the count limit register for group 1 when 
entering run mode. 

The count, CNT, action decrements the hardware counter. When the count 
reaches zero, the CL event becomes true. If all other conditions specified 
in the WHEN/THEN clause are satisfied, the appropriate action is taken. 

Whenever the reset count, RCT, action is specified, the count comparator 
value for the specified group is loaded into the hardware counter. When 
switching groups, the current value of. the hardware counter is passed 
along as a global count value unless a RCT action is specified in the same 
list of events that causes the group switch. 
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The toggle count, TOC, command provides a way to turn counting on and 
off. When a TOC event is detected, the count is toggled to the opposite 
state, either on or off. You can specify an event that starts and stops the 
counter each time it is detected or specify any number of events that toggle 
the counter on and off. 

The current value of the counter cannot be read. You can only detect 
when you have reached a limit. 

This table describes the count conditions immediately before an after a 
group change. 



1 

New Group 

1 1 


1 

Previous 

1 

| Nothing 

1 1 

i i 


1 

i 

Group 

| Specified 

1 CNT 1 

TOC 

i 

Nothing 

| No cycles 

| Count only | 

Count nothing 

i 

Specified 

| counted 

| qua I'd cycles | 

until first TOC 

i 

CNT 

| No cycles 

| Count only | 

Count nothing 

i 


| counted 

j qual'd cycles j 

until first TOC 

i 

TOC 

| No cycles 

| Count only | 

Count nothing 

i 

(Not counting) 

j counted 

| qual'd cycles | 

until first TOC 

t 

TOC 

| No cycles 

| Count only | 

Count all 

i 

(Tracing) 

| counted 

| qual'd cycles | 

_ i i 

until first TOC 

i 

i 

1 Mil 1 | 


( continued ) 
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This table describes initial count conditions (always group 1). 


Action 

ii 

Count 

Specified 

II 

Condition 


ii 

Count 


ii 

nothing 

CNT 

ii 

Count only 


n 

Qua I'd CNT events 

TOC 

n 

Count nothing 


n 

until TOC event 


Examples 


Count the times that the specified data are written to a specific address. 
Break if the data are written 20 times. 


>CL=#20 

>S1=WR 

>AC1=4020; DC1=$XXF3 
>WHEN AC1 AND DC1 AND Si THEN CNT 
>WHEN CL THEN BRK 
>RBK 
R> 
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To cause a break to occur after $400 writes have lapsed: 


si = WR 
CL = 400 

WHEN SI THEN CNT 
WHEN CL THEN BRK 


Look for a read from a specific I/O port. After it is found go to group 2, 
load the group 2 counter register value into the hardware counter and set a 
group 2 address comparator to count every bus cycle (all addresses). Break 
after 100 bus cycles. 


>AC1= 1 IOport 
>S1=RD 

>WHEN AC1 AND Si THEN GRO 2, RCT 
>CL.2=#100 
>AC1.2=0 TO -1 
>2 WHEN AC1 THEN CNT 
>2 WHEN CL THEN BRK 
>RBK 
R> 


/ continued ) 
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Trigger Signal 

The trigger signal is an output that is available from the BNC connector 
labelled TRIG on the back panel of the ESI800 chassis and from pin 19 of 
the optional LSA pod. When a TGR event is detected, the trigger signal is 
asserted, and remains so for the duration of the specified bus cycle. If a 
trigger event is specified for more than one consecutive bus cycle, the 
signal stays high for the duration of the consecutive bus cycles. 

The trigger signal can be used as a pulse output for triggering other 
diagnostic equipment. It can also be used in conjunction with a 
counter/timer for timing subroutines. 


Examples 


Trigger a scope when reading data from a UART. 


>AC1= 1 DATA_P0RT 
>S1=RD 

>WHEN AC1 AND SI THEN TGR 


Determine the duration of a subroutine using the trigger pulse. The trigger 
pulse can be the input to a counter/timer or a scope. The duration of the 
subroutine can be determined from the pulse width displayed on the scope 
or the counter/timer readout. 


>AC1=2500 

>AC1.2=AC1+38E 

>DC1.2=XXXX 


Start of subroutine 
End of subroutine 
Detect any data pattern 


>WHEN AC1 THEN TGR, GRO 2 
>2 WHEN DC1 THEN TGR 
>2 WHEN AC1 THEN GRO 1 
>RUN 
R> 


Go to group 2 when subroutine is entered 
Trigger during all cycles while in group 2 
Go back to group 1 when last instruction 
in subroutine is executed. 
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Special Interrupts 


Registers: 


SIA 

Value Type - 32 Bit Integer 

Events: 


FSI 



The force special interrupt action, FSI, provides a way to jump to a 
specified address when a specific event is detected. 

The special interrupt address register, SIA, should be set prior to entering 
run mode if you are using the FSI event. It defines the address your 
program vectors to when the FSI is executed. 

When an FSI event is detected, an |fsi active] message is displayed on the 
screen. You may also see some unusual cycles in the trace memory at the 
address where the FSI occurred. These are internal cycles that get traced 
as the execution address is changed. They are not purged from the trace 
memory because of the need for speed when executing an FSI. 

The FSI event can be used as a fast way to make a patch to your code. It is 
also used to write soft shutdown routines for machinery that cannot be 
halted using a simple breakpoint. 

The FSI routine residing at the SIA address should terminate with a return 
from exception (RTE) instruction. Execution will resume at the address 
immediately following the instruction that caused the FSI. If this is a soft 
shutdown, you will probably define a breakpoint at the RTE instruction. 


( continued ) 
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Examples 


Make a patch using overlay memory. 


>MAP 1000 

>AC1=8F36 

>UHEN AC1 THEN FSI 

>SIA=1000 



>ASM SIA 

Single 

line assembler - patch code 

>RUN 

R> 

can be 

assembled here. 


Assume the program needs to break at a certain address, but the machine 
cannot be turned off until a soft shutdown routine is executed. Set SIA to 
the address of the soft shutdown routine. Use an FSI action at the break 
address, then set a breakpoint at the end of the soft shutdown routine. 


>SIA= 1 SHUT_down 
>AC1=$7F4E2 
>AC2= 1 SHUT_down + 4E 
>WHEN AC1 THEN FSI 
>WHEN AC2 THEN BRK 
>RBK 
R> 
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Changing Event Groups 

The four event groups provide a way to detect sequential events. When 
emulation is entered, event monitoring always begins in group 1. The 
example below describes a common use of the EMS group structure. 

You may wish to trace a subroutine after it has been called by module A or 
module B, but not if it has been called from modules C, D, or E. In this 
case, you would define the address comparators in group 1 to the address 
ranges of modules A and B. When either of these modules is encountered, 
switch to group 2 and look for the subroutine. After tracing the 
subroutine, switch back to group 1. 


>'Module_A =1240 LEN 246 
>'Module_B =8750 LEN 408 
> 1 Sub_X =8934 LEN 56 

>ACl='Module_A 

>AC2='Module_B 

>WHE AC1 OR AC2 THE GRO 2 

>AC1.2= 1 Sub_X 

>2 WHEN AC1 THE TRC 
>2 WHE NOT AC1 THE GRO 1 


( continued ) 
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The TRC/TOT and CNT/TOC actions interact in a specific way when 
event groups are switched. The following state transition tables describe 
the actions taken when each of the different event combinations are 
specified. 


NEW GROUP 


PREVIOUS 

TOT 

GROUP 

Nothing 

specified 

TRC 

TOT 

Nothing 

specified 

| Trace all 
j eyeles 

1 

Trace only 
qual'd cycles 

Trace until 
first TOT 

TRC 

| Trace all 
| eyeles 

1 

Trace only 
qual'd cycles 

No Trace until 
first TOT 

TOT NOT 

TRACING 

1 

| Trace all 
| cycles 

1 

Trace only 
qua I'd cycles 

No Trace until 
first TOT 

TOT 

TRACING 

1 

| Trace all 
j cycles 

Trace only 
qual'd cycles 

Trace until 
first TOT 


NEW GROUP 


PREVIOUS 

GROUP 

Nothing 

specified 

TRC 

TOT 

Nothing 

specified 

| No cycles 
| counted 

1 

Count only 
qua I'd cycles 

No count until 
first TOC 

CNT 

1 

| No cycles 
| counted 

1 

Count only 
quaI'd cycles 

No count until 
first TOC 

TOC OFF 

1 

| No cycles 
j counted 

1 

Count only 
qual'd cycles 

No count until 
first TOC 

TOC ON 

1 

| No cycles 
| counted 

Count only 
qual'd cycles 

Count until 
first TOC 
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Section 8 


68020 EVENT MONITOR SYSTEM 


Overview 

The ES1800 Event Monitor System is based on a 16 bit environment. The 
68020 microprocessor consists of a 32 bit architecture. To incorporate the 
68020 into the ESI 800 chassis, some enhancements were introduced into 
the emulator’s operating system to facilitate selective tracing. The 68020 
microprocessor Event Monitor System including special tracing 
considerations is described in this chapter. Please review the entire 
chapter, including the last section on shortcuts, before using the Event 
Monitor System for the 68020 microprocessor. 

The ESI800 Event Monitor System (EMS) provides extremely flexible 
system and breakpoint control, enabling the user to isolate or break on any 
predefined series of events and then perform various actions. The user 
controls and monitors the target by entering commands that define events 
as logical combinations of address, data, status, count limit, and optional 
logic state probe inputs. When an event is detected, the ESI800 can break 
emulation, trace specific sequences, count events, execute user supplied 
target routines, and trigger a TTL output. 

WHEN/THEN control statements define events and their corresponding 
actions. There can be several actions for any event. The system only 
recognizes the first three letters of any word in a control statement (e.g., 
WHEN=WHE; THEN=THE). There can be many control statements in 
effect at any time. The Event Monitor System can also switch groups to 
allow for sequencing events. There are four event groups available and the 
control statements and comparator values for any group are independent of 
those in other groups. 
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Event Monitor System control statements can be entered while in run 
mode. The event comparator values can also be modified during run 
mode. However, these new statements and values will not go into effect 
until you stop and restart run mode. 

The ESI800 Event Monitor System monitors target information at the bus 
cycle level; i.e., every read or write cycle that the microprocessor executes. 
The EMS system detects every signal that can affect the target system. It 
can also monitor inputs from the logic state analyzer probe. 

The Event Monitor System essentially takes a picture of the Motorola 
68020 microprocessor’s signals at the end of every bus cycle (refer to 
Motorola manual, MC68020 32 Bit Microprocessor Users Manual). The 
information that is recorded into trace memory is the same information 
that the EMS is monitoring. 

The Event Monitor System will only break on the address information that 
was traced. The breakpoint comparators only look at the addresses output 
by the microprocessor. 

The basic Event Monitoring System control statement is of the form: 

[ Group 1 WHE[A1 <event> THE[M <action> 


Notice that the ESL command processor needs only the first three letters of 
the symbol. 

COMPARATOR REGISTERS 

An event is based on the value of a comparator register or a combination of 
comparator registers. Comparators can be combined with AND, OR, or 
NOT operators. The action that follows an event may be a single command 
or multiple commands separated by commas. 

There are eight comparator registers for each of the four event groups. 
These event registers are listed in the table on the following page. The 
address comparators are used to detect discrete addresses or addresses 
inside or outside a specified range. The data comparators can detect 
specific data patterns and can ignore specified bit positions. The status 
comparators monitor all of the status signals from the microprocessor as 
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well as some generated by the ESI800. The status comparators can also 
ignore bit positions. The count limit register can be used to detect when an 
event has occurred more than a specified number of times. The logic state 
analyzer register can detect bit patterns in the inputs from the logic state 
probe. 

The following table describes the available event comparator registers. 


Register 


Size 

Description 

Type 

(bits) 

Address 1 

Range, 

, Integer 

24 

Address 2 

Range, 

.Integer 

24 

Data 1 

Don't 

Care,Integer 

16 

Data 2 

Don't 

Care,Integer 

16 

Status 1 

Don't 

Care,Integer 

16 

Status 2 

Don't 

Care,Integer 

16 

LSA 

Don't 

Care,Integer 

16 

Count 

Integer 

16 


Name by Group 


i 

2 

3 

4 

AC1 or AC1.1 
AC2 or AC2.1 

AC1.2 

AC2.2 

AC1.3 

AC2.3 

AC1.4 

AC2.4 

DC1 or DC1.1 
DC2 or DC2.1 

DC1.2 

DC2.2 

DC1.3 

DC2.3 

DC1.4 

DC2.4 

51 or S1.1 

52 or S2.1 

51.2 

52.2 

51.3 

52.3 

51.4 

52.4 

LSA or LSA.1 

LSA. 2 

LSA. 3 

LSA. 4 

CL or CL.1 

CL.2 

CL.3 

CL.4 


ADDRESS COMPARATORS 

Address comparators may be assigned integer values or range values. 
Ranges may be either internal (IRA) or external (XRA). If a range is 
specified without IRA or XRA operators, the default range type will be 
IRA. 

DATA AND LSA COMPARATORS 

The data comparators monitor the data bus for specified patterns. The 
LSA comparators monitor the input pulses from the logic state probe. 

Data and LSA comparators may be assigned integer values or don’t care 
values. Don’t care values may be assigned in two ways. The first is to 
specify the value followed by the don’t care mask; the second is to specify 
the value using [x] in the don’t care positions. 
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STATUS COMPARATORS 

The status comparators are assigned values from the list of status constants. 
Many of these constants can be combined to specify a complex comparator 
value. The list on the next page shows the available mnemonics. Any of 
these statuses can cause events. 


STATUS MNEMONICS 


BER 

bus error 

IP 

interrupt pending 

A V 

autovector 

IP(0-7) 

interrupt Levels 0-7 

SP 

supervisor program 

SD 

supervisor data 

UP 

user program 

CPU 

CPU space 

SC(0-7)* 

numeric names for all 8 space codes* 

TAR 

target system access 

OVL 

overlay memory access 

RD 

read access 

UR 

write access 

BYT 

byte access 

URD 

word access 


COUNT LIMIT COMPARATOR 

The count limit comparator CL, is used to detect when events have 
occurred a certain number of times. The CL value for group 1 is loaded 
into a hardware counter which is decremented whenever the action CNT is 
executed (see the following sections on Defining Events and Action Lists). 
If a group switch occurs, the hardware counter can be loaded with the new 
group’s count limit by executing the RCT (reset count) action. Otherwise, 
the hardware counter will not change its limit value when switching 
groups. 
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Defining Events 

The Event Monitor System is arranged in four independent groups. These 
groups provide a state-machine capability for debugging difficult 
problems. EMS control statements are associated with one of the four 
groups. If no group numbers are mentioned in the EMS control statement, 
the statement will be assigned to group 1. There are two ways to override 
this default selection of group 1. You can begin the EMS control statement 
with a group number, or you can add a group number to any one of the 
event comparator names. For example: |3 when aci then brk| is functionally 
the same as |mhen aci.3 then brk| . You cannot mix group numbers within a 
single EMS control statement. 

EVENT 

You can define an event to be some combination of address, data, status, 
count and logic state probe conditions. Numerous Event Monitor System 
control statements can be entered and will all be in effect simultaneously. 
Conflicting statements may cause unpredictable action processing. 
Parentheses are not allowed in event specifications. 

The NOT operator is used to reverse the sense of the comparator output. 
NOT has higher precedence than either of the conjunctives. 
Imhen aci and not pci then brk! means break whenever any data pattern other 
than that in DC 1 occurs on the bus along with AC 1. 

AND and OR can be used where needed to form more restrictive event 
definitions. AND terms have higher precedence than OR terms. 
|aci and pci or dc2| is the same as |aci and dcT| in one statement and |dc2| in 
another. If you are looking for two different data values at an address, use 

1 ACI AND PCI OR ACI AND DC2| . 

The OR operator is evaluated left to right and is useful for simple 
comparator combinations. For complex event specifications, OR 
combinations can be replaced with separate EMS control statements for 
clarity. |aci and si or ac2 and S2| is the same as |aci and sf| and |AC2 and S2| . 
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Defining Action Lists 

The action list in a WHEN/THEN statement defines what the Emulator 
does when an event is detected. Actions are specified in an action list 
separated by commas. The action list may have one or more actions 
defined. 


Examples 


<group> WHEN <event> THEN < action>.<action>, ... ,<action> 
The following table lists all possible actions. 


Event Monitor System Actions 


Action 

Description 

BRK 

Break emulation 

CNT 

Count Bus Cycle 

FSI 

Force Special Interrupt 

GRO 

Change Event Group 

RCT 

Load Count Value 

TGR 

Output Trigger Signal 

TOC 

Toggle Count State 

TOT 

Toggle Trace State 

TRC 

Trace Bus Cycle 


The TRC and TOT actions are described in the Tracing Events section. 
The CNT, RCT, and TOC actions are described in the Counting Events 
section. The FSI action is described in the Special Interrupt section. The 
GRO action is described in the Changing Event Groups section. The TGR 
action is described in the Trigger Signal section. The BRK is described in 
the Breaking Emulation section. 
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The EMS will always resolve conflicting EMS control statements. The 
TOC action in the first statement will be changed to CNT. 


>WHEN AC1 THEN TOC 
>UHEN AC1 THEN CNT 
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DISPLAY EVENT SPECIFICATIONS 


Command 


Result 


DES Displays all of the 

WHEN/THEN statements 
currently active from all groups. 

DES <group number > Displays all of the 

WHEN/THEN statements and 
the comparator values for the 
specified group. 
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DISPLAY EVENT SPECIFICATIONS (cont.) 


Examples 


Display the statements and comparators for groups 1 and 2. 


>DES 1;DES 2 

1 WHEN AC1 THEN BRK 
AC1.1 = S007632 
AC2.1 = $000000 
DC1.1 = $0000 
DC2.1 = $0000 

51 .1 = $0000 

52 .1 = $0000 
LSA.1 = $0000 
CL .1 = $0000 

2 WHEN SI AND DC1 THEN CNT,TRC 
2 WHEN CL THEN BRK 

AC1.2 = $000000 
AC2.2 = $000000 
DC1.2 = $40FF DC $00FF 
DC2.2 = $0000 

51 .2 = $0003 DC $FFFC 

52 .2 = $0000 
LSA.2 = $0000 
CL .2 = $0010 
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CLEAR WHEN/THEN STATEMENTS 


Command 


Result 


CES 


Clears all of the WHEN/THEN 
statements currently active. 


CES <group number> Clears all of the WHEN/THEN 

statements for the specified 
group. 


Comments 


The comparator values are not affected by the CES command. 
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Breaking Emulation 

The BRK action stops emulation, returning the system to pause mode. 
When a break event is detected and emulation has been broken, the current 
PC and event group is displayed on the terminal. Emulation begins at the 
values displayed if the registers are not altered and you run or step 
following a break. When entering emulation, the Event Monitor System 
always begins looking for events specified in group 1. 

Breakpoints stop program execution at specific times. After a break you 
can disassemble the trace memory, look at the LSA bits in the raw trace, 
check the CPU register values, or begin stepping through your code. 

Breakpoint actions may be enabled or disabled by selecting the appropriate 
run commands. If you enter emulation with the RBK or RBV run 
commands, breakpoints are enabled. If you enter emulation with the RUN 
or RNV commands, breakpoints are disabled, even if there are event 
statements specifying the BRK action. If emulation is entered with 
breakpoints disabled, you can enable them while running by entering the 
RBK command. If you enter emulation with breakpoints enabled, you can 
disable them while running by entering the RUN command. The RNV and 
RBV commands are not allowed during emulation. These commands load 
the reset vectors, which cannot be done during emulation. 

Emulation may be halted using the STP command. The reset character 
(Default is [ctrl| [z1. May be changed through the Set command, option 2) 
also breaks emulation. 


( continued ) 
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Tracing Events 


Events: 


TRC 

TOT 


The Event Monitor System can be set up to trace bus cycles selectively. If 
all of the conditions specified in the event portion of the WHEN/THEN 
clause are satisfied, the trace action, TRC, causes the specified bus cycle to 
be recorded into the trace memory. 

The toggle trace, TOT, provides a way to turn tracing on and off. When a 
TOT event is detected, the trace is toggled to the opposite state, either on 
or off. You can specify a single event that starts and stops trace each time 
it is detected or specify any number of events that toggle trace on and off. 

If there are no event actions that specify TRC or TOT, all bus cycles are 
traced. If there is a TRC event, only qualified bus cycles are traced. If 
there is a TOT event, trace will be off until the TOT is detected, then all 
bus cycles are traced until encountering another TOT event. 
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This table describes the trace conditions immediately before and 
immediately after a group change. 


Previous 

Group 

II 

|| Nothing 
jj Specified 

New Group 

i i 

i i 

i trc i 

TOT 

i 

i 

i 

Nothing 

j | T race 

j Trace only | 

Trace nothing 

i 

Specified 

|| all cycles 

| qual'd cycles | 

until first TOT 

i 

TRC 

| | Trace 

j Trace only | 

Trace nothing 

i 


|| all eyeles 

| qual'd cycles | 

until first TOT 

i 

TOT 

| | Trace 

| Trace only | 

Trace nothing 

i 

(Not tracing) 

|| all cycles 

j qual'd cycles j 

until first TOT 

i 

TOT 

| | Trace 

j Trace only | 

Trace nothing 

i 

(Tracing) 

jj all eyeles 

.M _ _ 

j qual'd cycles j 

until first TOT 

i 

_ i 

1__!_ 1 _ 1 _ 


This table describes initial trace conditions. 


Action 

ii 

Trace 

Specified 

M 

Condition 

Nothing 

n 

ii 

Trace 
all cycles 

TRC 

ii 

M 

Trace only 

Qual'd TRC events 

TOT 

n 

Trace nothing 


ii 

until TOT event 


( continued ) 
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Tracing and Breaking with the 68020 

The ESI800 Event Monitor System is based on a 16 bit environment. The 
68020 microprocessor consists of a 32 bit architecture. To incorporate the 
68020 into the ESI800 chassis, some enhancements were introduced to the 
Emulator’s operating system to facilitate selective tracing. 

The 68020 has a wider address and data path than the 68000/08/10 and 
other 16 bit processors. The ES1800 chassis was designed for the 16 bit 
processors and therefore has a 70 bit trace memory. Because of the 70 bit 
wide trace, it is not possible to trace all of the 68020 signals that might be 
of interest at the same time. Instead, a selective trace mode is available to 
allow the user to pick which bits are to be traced depending on the current 
stage of development. There are four modes the user may choose from and 
the bits utilized are listed below: 


MODE 

ADDR 

DATA 

STATUS 

TIMER 

LSA 

0 

24 

16 

19 

24 

16 

1 

24 

32 

19 

24 

0 

2 

32 

32 

11 

24 

0 

3 

32 

16 

21 

24 

6 


Regardless of which trace mode is selected, the following information is 
always traced and is displayed by the Event Monitor System: 


A0 - A23 
D16 - D31 
R/W~ 
TGT/OVL 
FC0 - FC2 


To program the Event Monitor System, a detailed description of the signals 
traced and their location in the event comparators is needed. The chart on 
page 8-17 shows the signals and their locations for the four trace modes. 
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MODE SELECTION 

The Event Monitor System in the ESI800 is designed to use the trace 
information to cause the event actions. In the 68020, the trace information 
is different depending on the selected mode (0, 1, 2, or 3). Refer to SET 
menu, line #4. 


Trace mode 0...page 8-19 

When using trace mode 0, the event system operates basically the same as 
the present 68010 EMS system. The AVEC" signal replaces VPA~ and 
IPEND" replaces VMA*. The breakpoint assembler recognizes AV for 
AVEC and IP for IPEND. Five additional signals are traced: OCS, 
DSACK1, DSACK0, SIZ1, and SIZ0. 

Be aware, however, that only 24 address and 16 data bits are being traced 
which means that the upper 8 address bits and the lower 16 data bits are 
ignored. Also, RMC" and CDIS" are not traced in Mode 0. 


Trace mode l...page 8-27 

Trace mode 1 would be selected by the user if all 32 bits of data needed to 
be traced. As in trace mode 0, the high 8 address bits are ignored. All the 
signals traced in trace mode 0 are also used in mode 1 except the 16 LSA 
bits, which are replaced by data bits 0-15. 


Trace Mode 2...page 8-36 

Trace mode 2 would be selected if all 32 address and data bits need to be 
traced. The LSA bits are replaced with data bits 0-15, and certain status 
bits are replaced with A24-A31. IPLO-2", IPEND", BERR", and AVEC" 
are not traced in this mode. 


Trace Mode 3...page 8-45 

Trace mode 3 would be selected to trace 32 address, 16 data, and all status 
lines. There are 6 LSA lines available for use in this mode. 


( continued ) 
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Figure 9. Address data , status lines and LSA bits for each trace mode 



101 BITS 


ACX 

BITS 

DCX 

BITS 

TIMER 

BITS 

STATUS BITS 

SX BITS 

LSA BITS 

BIT 

NO. 

A23 - AO 

D15 «- DO 

T23 <- TO 

OCS, DSACK1,DSACK0, SIZ1, SIZO 

S15 

S14 

S13 

S12 

S11 

S10 

S9 

S8 

S7 

S6 

S5 

S4 

S3 

S2 

SI 

SO 


MODE 

0 

A23 <- AO 


o 

i— 

i 

CO 

CM 

1— 

OCS, DSACK1.DSACK0, SIZ1, SIZO 

0 

IP 

AV 

BRK 

IPL2 

IPL1 

IPLO 

BER 

MAV/ 

MWV 

FC2 

FC1 
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0 
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OVL 

R/W 

B/W 
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MODE 

1 

A23 4 - AO 


T23 - TO 

OCS, DSACK1.DSACK0, SIZ1, SIZO 

0 

IP 

AV 

BRK 

IPL2 

IPL1 

IPLO 

BER 

MAV/ 

MWV 

FC2 

FC1 

FCO 

0 

TGT/ 

OVL 

R/W 

B/W 

Below 

MODE 

2 

A23 <- AO 


T23 - TO 

OCS, DSACK1.DSACK0, SIZ1, SIZO 

0 

A31 

A30 

A29 

A28 

A27 

A26 

A25 

A24 

FC2 

FC1 

FCO 

0 

TGT/ 

OVL 

R/W 

B/W 


MODE 

3 

A23 <- AO 


T23 - TO 

OCS, DSACK1.DSACK0, SIZ1, SIZO 

0 

IP 

AV 

BRK 

IPL2 

IPL1 

IPLO 

BER 

MAV/ 
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LSA BITS 

LS15 

LS14 

LS13 

LS12 

LS11 

LS10 

LS9 

LS8 

LS7 

LS6 

LS5 

LS4 

LS3 

LS2 

LSI 

LSO 

LS15 

LS14 

LS13 

LS12 

LS11 

LS10 

LS9 

LS8 

LS7 

LS6 

LS5 

LS4 

LS3 

LS2 

LSI 

LSO 

D15 

D14 

D13 

D12 

Dll 

DIO 

D9 

D8 

D7 

D6 

D5 

D4 

D3 

D2 

D1 

DO 

D15 

D14 

D13 

D12 

Dll 

DIO 

D9 

D8 

D7 

D6 

D5 

D4 

D3 

D2 

D1 

DO 

A31 

A30 

A29 

A28 

A27 

A26 

A25 

A24 

RMC 

CDS 

L5 

L4 

L3 

L2 

LI 

L0 


( continued ) 
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Trace Mode 0 

When using trace mode 0, the 40 conductor cable from the pod is not used. 
It may be removed from the Logic State Probe connector on the front panel 
of the ES and the optional Logic State Probe installed. 

Figure 10. Trace Mode 0 



When using trace mode 0, the event system operates basically the same as 
the 68000/08/10 EMS system. The AVEC" signal replaces VP A' and 
IPEND replaces VMA . The breakpoint assembler recognizes AV for 
AVEC and IP for IPEND. Five additional signals are traced: OCS, 
DSACK1, DSACK0, SIZ1, and SIZ0. 

Be aware, however, that only 24 address and 16 data bits are being traced 
which means that the upper 8 address bits and the lower 16 data bits are 
ignored. Also, RMC and CDIS~ are not traced in mode 0. 


( continued ) 
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SETUP 

To select mode 0 operation, type in: 


> SET 4,0 


To view the selected mode of operation, type in: 


> SET (refer to line #4) 


OPERATION 

The ESI800 Event Monitor System is designed to use trace information to 
cause event actions. In the 68020, trace information is different depending 
on the selected mode (0, 1,2, 3). 

The trace buffer contains 24 address bits, 16 data bits, 20 status bits, 16 
logic state bits, and 24 timer bits. For mode 0, these bits trace the 
following: 

Trace address bits: 


A0 through A23 on the trace card will trace 
A0 through A23 of the 68020 address bus. 


Trace data bits: 


DO through D15 on the trace card will trace 
D16 through D31 of the 68020 data bus. 
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Trace status bits: 

SO through S14 on the trace card will trace: 

Interrupt Pending 

(S14) 

Autovector 

(S13) 

Break 

(S12) 

Interrupt Line 2 

(sin 

Interrupt Line 1 

(S10) 

Interrupt Line 0 

(S9) 

Bus Error 

(S8) 

Memory Access Violation 

(S7) 

Memory Write Violation 

CS7) 

Function code line 2 

(S6) 

Function code line 1 

(S5) 

Function code line 0 

(S4) 

(not used) 

(S3) 

TGT/OVL 

(S2) 

Read/Write 

(SI) 

Byte/Word 

(SO) 

Additional bits displayed in 


raw trace: 


OCS 


DSACKO 


DSACK1 


SIZO 


SIZ1 


Trace logic state bits: 

LSO through LSI5 on the trace 

card will trace 

LSO through LS15 of the logic 

state pod. Please refer 

to installation instructions 

(page 8-64) for set up. 


Examples 


When setting up the Event Monitor System, comparators are used to 
qualify the event actions. Please refer to page 8-2, for a complete 
description. The comparators used are: 


( continued) 
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■ Two address comparators for use with the address area of 
the trace: AC1 and AC2 

■ Two data comparators for use with the data area of the 
trace: DC1 and DC2 

■ Two status comparators for use with the status area of the 
trace: SI and S2 

■ One logic state comparator for use with the logic state area 
of the trace: LSA 

■ One count limit comparator for use with the internal count 
register: CL 

When assigning values to AC1 and AC2, single values and ranges are 
acceptable. DC1, DC2 and LSA may have masked values. The CL register 
can be between 1 and $FFFF. 

The status comparators (SI and S2) may be set up with a variety of 
different conditions to further qualify your particular event action. The 
acceptable statuses are as follows: 


BYT or WRD 
RD or WR 
TAR or OVL 

Any one of the function codes SCO 

SC1/UD 

SC2/UP 

SC3 

SC4 

SC5/SD 

SC6/SP 

SC7/CPU 

BER 

Any one of the interrupt priorities, IPO through IP7 
AV (autovector) 

IP (interrupt pending) 


When setting up a status comparator, the following examples are 
acceptable: 
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S1=BYT 

S1=RD+0VL 

S2=BER+TAR 

S2=SC4+RD+BYT 

S1=IP4 


As you can see, multiple choices for the status comparators are allowed, 
however, only one from each category should be used. For example, you 
should not set the status comparator to BYT+WRD, RD+WR, or SC3+SC4 
because these types of statuses would not happen simultaneously. 

Therefore, SI and S2 can equal the following: 


STATUS MNEMONIC TABLE 


SI = BYT + RD + TAR + SCO + BER 
URD WR OVL SC1/UD 
SC2/UP 
SC3 
SC4 

SC5/S0 

SC6/SP 

SC7/CPU 

(Only one out of each category) 


+ IPO + AV + IPO + AV + IP 
IP1 
IP2 
IP3 
IP4 
IP5 
IP6 
IP7 


( continued) 
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STATUS 

COMPARATOR 

BREAKDOWN 


14 13 

12 

11 10 

9 8 7 

6 5 4 

3 2 10 

i i 

i 

\ 1 / 

i 

\ 1 / 

i i i 

1=IP 1=AV 


0=IP0 

1=BER 

o=sco 

1=OVL | | 



1=IP1 


1=SC1/UD 

1=TAR j j 



2=IP2 


2=SC2/UP 

0=UR j 



3=IP3 


3=SC3 

1=RD j 



4=1 P4 


4=SC4 

0=WRD 



5=IP5 


5=SC5/SD 

1=BYT 



6=IP6 


6=SC6/SP 




7=IP7 


7=SC7/CPU 



STATUS COMPARATOR BIT REPRESENTATION 

IP=00004000 DC BFFF 
AV=00002000 DC DFFF 
IP0=00000000 DC FF1F 
I PI=00000200 DC F1FF 
IP2=00000400 DC F1FF 
IP3=00000600 DC F1FF 
IP4=00000800 DC F1FF 
1P5=00000A00 DC F1FF 
IP6=00000C00 DC F1FF 
IP7=00000E00 DC F1FF 
BER=00000100 DC FEFF 
SC0=00000000 DC FF8F 
SC1/UD=00000010 DC FF8F 
SC2/UP=00000020 DC FF8F 
SC3=00000030 DC FF8F 
SC4=00000040 DC FF8F 
SC5/SD=00000050 DC FF8F 
SC6/SP=00000060 DC FF8F 
SC7/CPU=00000070 DC FF8F 
TAR=00000004 DC FFFB 
OVL=00000000 DC FFFB 
RD=00000002 DC FFFD 
UR=00000000 DC FFFD 
BYT=00000001 DC FFFE 
WRD=00000000 DC FFFE 
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Example of mode 0 display: 


>SET 

ES SETUP: SEE MANUAL FOR DETAILS... 

SET #X, #Y - SET ITEM X TO VALUE CORRESPONDING TO Y 

LD 0;SAV 0 LOAD/SAVE SETUP FOR CURRENTLY SELECTED USER 

SYSTEM: 

#1 USER = 0; [0,1] 

#2 RESET CHAR = $1A 

#3 XON, XOFF = $11, $13 

#4 TRACE MODE = 0; [0, 1, 2, 3] 

TERMINAL: 

#10 BAUD RATE = #14; [2=110, 5=300, 10=2400, 14=9600 
#11 STOP BITS = 1; [1, 2] 

#12 PARITY = 0; [0=NONE, 1=EVEN, 2=ODD] 

#13 CRT LENGTH = #24 

#14 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 

COMPUTER: 

#20 BAUD RATE = #7; [7=1200, 12=4800, 15=19200] 

#21 STOP BITS = 1 
#22 PARITY = 0 

#23 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 
#24 COMMAND TERMINATOR SEQUENCE = $0D, $00, $00 
#25 UPLOAD RECORD LENGTH = #32; [1 TO 127] 

#26 DATA FORMAT = 2; [0=INT, 1=MOS, 2=MOT, 3=SIG, 4=TEK, 5=XTEK] 
#27 ACKNOWLEDGE CHAR = $06 


( continued ) 
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Example of mode 0 display: 


>DRT 











LINE 

ADDRESS 


DATA 

R/W 


FC 

I PL 

LSA • 8 

7 - 0 

TIME 

#20 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 

X11111111 

Xllllllll 

307.418 MS 

#19 

F0053E 

> 

FFF8 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.418 MS 

#18 

F00540 

> 

6024 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.419 MS 

#17 

F00542 

> 

4A03 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.420 MS 

#16 

F00534 

> 

007E 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.421 MS 

#15 

F00536 

> 

301A 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.421 MS 

#14 

F00538 

> 

E309 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.422 MS 

#13 

F0053A 

> 

6506 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.423 MS 

#12 

F005BA 

> 

0000 

R 

TAR 

SD 

0 

%11111111 

Xllllllll 

307.424 MS 

#11 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.424 MS 

#10 

F0053E 

> 

FFF8 

R 

TAR 

SP 

0 

%11111111 

Xllllllll 

307.425 MS 

#9 

F00540 

> 

6024 

R 

TAR 

SP 

0 

X11111111 

Xllllllll 

307.426 MS 

#8 

F00542 

> 

4A03 

R 

TAR 

SP 

0 

IP XI1111111 

Xllllllll 

307.427 MS 

#7 

F00534 

> 

007E 

R 

TAR 

SP 

0 

IP X11111111 

Xllllllll 

307.427 MS 

#6 

F00536 

> 

301A 

R 

TAR 

SP 

0 

IP Xllllllll 

Xllllllll 

307.428 MS 

#5 

F00538 

> 

E309 

R 

TAR 

SP 

0 

IP X11111111 

Xllllllll 

307.429 MS 

#4 

F0053A 

> 

6506 

R 

TAR 

SP 

0 

IP XI1111111 

Xllllllll 

307.429 MS 

#3 

F005BC 

> 

0000 

R 

TAR 

SD 

0 

IP XI1111111 

Xllllllll 

307.430 MS 

#2 

F0053C 

> 

51CB 

R 

TAR 

SP 

0 

IP X11111111 

Xllllllll 

307.431 MS 

#1 

F0053E 

> 

FFF8 

R 

TAR 

SP 

0 

IP Xllllllll 

Xllllllll 

305.431 MS 

#0 

BREAK 
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Trace Mode 1 

Trace mode 1 requires that the 40 conductor cable from the pod be 
connected to the Logic State Probe connector on the front panel of the ES. 

Figure 11. Trace Mode 1 and 2 



Trace mode 1 would be selected by the user if all 32 bits of data needed to 
be traced. As in trace mode 0, the high 8 address bits are ignored. All the 
signals traced in trace mode 0 are also used in mode 1 except the 16 LSA 
bits, which are replaced by data bits 0-15. The LSA field in the raw trace 
display is not shown. The Event Monitor System, however, still uses the 
LSA comparator for this field, so in order to detect a 32 bit data event, a 
data comparator and the LSA comparator must be set up. 

SETUP 

To select mode 1 operation, type in: 


>SET 4,1 


( continued ) 
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To view the selected mode of operation, type in: 


>SET (refer to line #4) 


Disconnect the Logic State Probe option and replace with the smaller cable 
that comes out of the 68020 pod. 

OPERATION 

The ESI800 Event Monitor System is designed to use trace information to 
cause event actions. In the 68020, trace information is different depending 
on the selected mode (0, 1, 2, or 3). 

The trace buffer contains 24 address bits, 16 data bits, 20 status bits, 16 
logic state bits, and 24 timer bits. For mode 1, these bits trace the 
following: 

Trace address bits: 


A0 through A23 on the trace card will trace 
A0 through A23 of the 68020 address bus. 


Trace data bits: 


DO through D15 on the trace card will trace 
D16 through D31 of the 68020 data bus. 
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Trace status bits: 


SO through S14 on the trace 

card will trace: 

Interrupt Pending 

(S14) 

Autovector 

(S13) 

Break 

(S12) 

Interrupt Line 2 

(S11) 

Interrupt Line 1 

(S10) 

Interrupt Line 0 

(S9) 

Bus Error 

(S8) 

Memory Access Violation 

<S7) 

Memory Write Violation 

<S7) 

Function code line 2 

<S6) 

Function code line 1 

(S5) 

Function code line 0 

(S4) 

(not used) 

(S3) 

TGT/OVL 

(S2) 

Read/Write 

(SI) 

Byte/Word 

(SO) 

1 Additional bits displayed in 

raw trace: 


OCS 


DSACKO 


DSACK1 


SIZO 


SIZ1 



Trace logic state bits: 


LSO through LS15 on the trace card will trace 
DO through D15 of the 68020 data bus. 


When viewing the raw trace, all information will be in logical areas for 
easy viewing. For example, even though the logic state bits are tracing the 
lower data bits, the lower data bits will show in the data field of the trace. 
The only item that is affected by this arrangement is the way the 
comparators are used for setting up the Event Monitor System. 


( continued ) 
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Examples 


When setting up the Event Monitor System, comparators are used to 
qualify the event actions. Please refer to page 8-2 for a complete 
description. The comparators used are: 

■ Two address comparators for use with the address area of 
the trace: AC1 and AC2 

■ Two data comparators for use with the data area of the 
trace: DC 1 and DC2 

■ Two status comparators for use with the status area of the 
trace: SI and S2 

■ One logic state comparator for use with the lower data bits 
of the trace: LSA 

■ One count limit comparator for use with the internal count 
register: CL 

When assigning values to AC1 and AC2, single values and ranges are 
acceptable. DC1, DC2 and LSA may have masked values. The CL register 
can be between 1 and $FFFF. 

To set up a comparator using the data bus, please remember to use the data 
comparators (DC1 and DC2) and the logic state comparator (LSA). For 
example, to break on data pattern $12345678, use the following procedure: 


>DC1=$1234 

>LSA=$5678 

>UHEN DC1 AND LSA THEN BRK 
>RBK 


Notice the LSA comparator is used for the lower data bits (D0-D15) and 
DC1 is used for the upper data bits (D16-D32). 
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The status comparators (SI and S2) may be set up with a variety of 
different conditions to further qualify your particular event action. The 
acceptable statuses are as follows: 


BYT or WRD 
RD or WR 
TAR or OVL 

Any one of the function codes SCO 

SC1/UD 

SC2/UP 

SC3 

SC4 

SC5/SD 

SC6/SP 

SC7/CPU 

BER 

Any one of the interrupt priorities, IPO through IP7 
AV (autovector) 

IP (interrupt pending) 


When setting up a status comparator, the following examples are 
acceptable: 


S1=BYT 

S1=RD+OVL 

S2=BER+TAR 

S2=SC4+RD+BYT 

S1=IP4 


As you can see, multiple choices for the status cmparators are allowed, 
however, only one from each category should be used. For example, you 
should not set the status comparator to BYT+WRD, RD+WR, or SC3+SC4 
because these types of statuses would not happen simultaneously. 


( continued) 
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Therefore, SI and S2 can equal the following: 



STATUS MNEMONIC 

TABLE 

Si = BYT + RD + TAR 

+ SCO + BER + 

IPO + AV + IPO + AV + IP 

WRD WR OVL 

SC1/UD 

IP1 


SC2/UP 

IP2 


SC3 

IP3 


SC4 

IP4 


SC5/SD 

IP5 


SC6/SP 

IP6 


SC7/CPU 

IP7 

(Only one out of each category) 






STATUS 

COMPARATOR 

BREAKDOWN 


14 13 

12 

11 

10 9 

8 7 

6 5 4 

3 2 10 

i i 

i 

\ 

i / 

i 

\ i / 

i i i 

1=IP 1=AV 



0=IP0 

1=BER 

o=sco 

0=OVL | j 




1=IP1 


1=SC1/UD 

1=TAR | j 




2=IP2 


2=SC2/UP 

0=WR | 




3=IP3 


3=SC3 

1=RD j 




4=IP4 


4=SC4 

0=WRD 




5=IP5 


5=SC5/SD 

1=BYT 




6=IP6 


6=SC6/SP 





7=1 P7 


7=SC7/CPU 
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STATUS COMPARATOR BIT REPRESENTATION 

IP=00004000 DC BFFF 
AV=00002000 DC DFFF 
IP0=00000000 DC FF1F 
IP1=00000200 DC F1FF 
IP2=00000400 DC FIFF 
IP3=00000600 DC F1FF 
IP4=00000800 DC FIFF 
IP5=00000A00 DC F1FF 
IP6=00000C00 DC F1FF 
IP7=00000E00 DC F1FF 
BER=00000100 DC FEFF 
SCO=00000000 DC FF8F 
SC1/UD=00000010 DC FF8F 
SC2/UP=00000020 DC FF8F 
SC3=00000030 DC FF8F 
SC4=00000040 DC FF8F 
SC5/SD=00000050 DC FF8F 
SC6/SP=00000060 DC FF8F 
SC7/CPU=00000070 DC FF8F 
TAR=00000004 DC FFFB 
OVL=00000000 DC FFFB 
RD=00000002 DC FFFD 
WR=00000000 DC FFFD 
BYT=00000001 DC FFFE 
WRD=00000000 DC FFFE 


( continued ) 
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Example of mode 1 display: 


>SET 

ES SETUP: SEE MANUAL FOR DETAILS... 

SET #X, #Y - SET ITEM X TO VALUE CORRESPONDING TO Y 

LD 0;SAV 0 LOAD/SAVE SETUP FOR CURRENTLY SELECTED USER 

SYSTEM: 

#1 USER = 0; [0,1] 

#2 RESET CHAR = $1A 

#3 XON, XOFF = $11, $13 

#4 TRACE MODE = 1; [0, 1, 2, 3] 

TERMINAL: 

#10 BAUD RATE = #14; [2=110, 5=300, 10=2400, 14=9600 
#11 STOP BITS =1; [1,2] 

#12 PARITY = 0; [0=NONE, 1=EVEN, 2=ODD] 

#13 CRT LENGTH = #24 

#14 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 

COMPUTER: 

#20 BAUD RATE = #7; [7=1200, 12=4800, 15=19200] 

#21 STOP BITS = 1 
#22 PARITY = 0 

#23 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 
#24 COMMAND TERMINATOR SEQUENCE = $0D, $00, $00 
#25 UPLOAD RECORD LENGTH = #32; [1 TO 127] 

#26 DATA FORMAT = 2; [0=INT, 1=MOS, 2=MOT, 3=SIG, 4=TEK, 5=XTEK] 
#27 ACKNOWLEDGE CHAR = $06 
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Example of mode 1 display: 


>DRT 


LINE 

ADDRESS 


DATA 

R/W 


FC 

IPL 


DS 

sz 

ocs 

TIME 


#20 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#19 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#18 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#17 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#16 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#15 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#14 

F00538 

> 

E309FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#13 

F0053A 

> 

6506FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#12 

F005B4 

> 

004AFFFF 

R 

TAR 

SD 

0 


01 

10 

0 

1.396 

S 

#11 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#10 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#9 

F00540 

> 

6024FFFF 

R 

TAR 

SP 

0 


01 

00 

0 

1.396 

S 

#8 

F00542 

> 

4A03FFFF 

R 

TAR 

SP 

0 


01 

10 

1 

1.396 

S 

#7 

F00534 

> 

007EFFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#6 

F00536 

> 

301AFFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 

#5 

F00538 

> 

E309FFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#4 

F0053A 

> 

6506FFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 

#3 

F005B6 

> 

0056FFFF 

R 

TAR 

SD 

0 

IP 

01 

10 

0 

1.396 

S 

#2 

F0053C 

> 

51CBFFFF 

R 

TAR 

SP 

0 

IP 

01 

00 

0 

1.396 

S 

#1 

F0053E 

> 

FFF8FFFF 

R 

TAR 

SP 

0 

IP 

01 

10 

1 

1.396 

S 

#0 

BREAK 














( continued ) 


8-35 






ES 1800 Emulator Reference Manual for 68000 Series Microprocessors 


Trace Mode 2 

Using trace mode 2 requires that the 40 conductor cable from the pod be 
connected to the Logic State Probe connector on the front panel of the ES. 

Figure 12. Mode 1 and 2 



Trace mode 2 would be selected if all 32 address and data bits need to be 
traced. The LSA bits are replaced with data bits 0-15, and certain status 
bits are replaced with A24-A31. IPLO-2", IPEND~, BERR~, and AYEC" 
are not traced in this mode. 

SETUP 

To select mode 2 operation, type in: 


>SET 4,2 


To view the selected mode of operation, type in: 
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>SET (refer to line #4) 


Disconnect the Logic State Probe option and replace with the smaller cable 
that comes out of the 68020 pod. 

OPERATION 

The ESI800 Event Monitor System is designed to use trace information to 
cause event actions. In the 68020, trace information is different depending 
on the selected mode (0, 1, 2, or 3). 

The trace buffer contains 24 address bits, 16 data bits, 20 status bits, 24 
timer bits, and 16 logic state bits. For mode 2, these bits trace the 
following: 

Trace address bits: 


A0 through A23 on the trace card will trace 
A0 through A23 of the 68020 address bus. 


Trace data bits: 


DO through D15 on the trace card will trace 
D16 through D31 of the 68020 data bus. 


( continued ) 
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Trace status bits: 


SO through S14 on the trace card will trace: 


68020 Address Bit 31 (S14) 
68020 Address Bit 30 (S13) 
68020 Address Bit 29 (S12) 
68020 Address Bit 28 (S11) 
68020 Address Bit 27 (S10) 
68020 Address Bit 26 (S9) 
68020 Address Bit 25 (S8) 
68020 Address Bit 24 (S7) 
Function code line 2 (S6) 
Function code line 1 (S5) 
Function code line 0 (S4) 
(not used) (S3) 
TGT/OVL (S2) 
Read/Write (SI) 
Byte/Word (SO) 


Trace logic state bits: 


LS0 through LSI5 on the trace card will trace 
DO through D15 of the 68020 data bus. 


When viewing the trace, all information will be in logical areas for easy 
viewing. For example, even though the logic state bits are tracing the 
lower data bits, the lower data bits will show in the data field of the trace. 
The only item that is affected by this arrangement is the way the 
comparators are used for setting up the Event Monitor System. 


Examples 


When setting up the Event Monitor System, comparators are used to 
qualify the event actions. Please refer to page 8-2 for a complete 
description. The comparators used are: 

■ Two address comparators for use with the address area of 
the trace: AC1 and AC2 
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■ Two data comparators for use with the data area of the 
trace: DC1 and DC2 

■ Two status comparators for use with the status area of the 
trace: SI and S2 

■ One logic state comparator for use with the lower data bits 
of the trace: LSA 

■ One count limit comparator for use with the internal count 
register: CL 

When assigning values to AC1 and AC2, single values and ranges are 
acceptable. DC 1, DC2 and LSA may have masked values. The CL register 
can be between 1 and $FFFF. 

To set the Event Monitor System to break on a 32 bit address, please 
remember that you will need to use a status comparator (SI or S2) and an 
address comparator (AC1 or AC2). For example, to break on the address 
value $FFFF3040, use the following procedure: 


>AC1=$FF3040 
>S1=$7F80 DC $807F 
>WHEN AC1 AND SI THEN BRK 
>RBK 


Notice the AC1 comparator is looking for the lower 24 bits (A0-A23) and 
the SI comparator (S7-S14) is looking for the upper 8 address bits (A24- 
A31). The "DC $807F" is a mask that will cause the Event Monitor System 
to ignore the other information being traced on those particular status lines 
when determining if a comparator has been reached. However, the trace 
will still display that information. It may be simpler to use binary. In this 
case type the following: 


>S1=%011111ll 10000000 DC %1000000001 mill 


SI will be displayed in hexadecimal unless the global default (DFB) or the 
SI default base has been altered. Please refer to page 5-85. 


( continued ) 
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The following chart may aid in determing the status values to select. 



Another example of breaking on a 32 bit address using address $12345678 
would be: 


>AC1=$345678 

>S1 =$900 DC $807F 

>UHEN AC1 AND SI THEN BRK 

>RBK 


To set up a comparator using the data bus, remember to use the data 
comparators (DC1 and DC2) and the logic state comparator (LSA). For 
example, when trying to break on the data pattern $12345678, use the 
following procedure: 


>DC1=$1234 

>LSA=$5678 

>UHEN DC1 AND LSA THEN BRK 
>RBK 


Notice the LSA comparators (SI and S2) is used for the lower data bits 
(D0-D15) and DC1 is used for the upper data bits (D16-D32). 

The status comparator may be set up with a variety of different conditions 
to further qualify your particular event action. The acceptable statuses are 
as follows: 
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BYT or URD 


RD or WR 


TAR or OVL 


Any one of the function codes 

SCO 


SC1/U0 


SC2/UP 


SC3 


SC4 


SC5/SD 


SC6/SP 


SC7/CPU 


When setting up a status comparator, the following examples are 
acceptable: 


S1=BYT 

S1=RD+OVL 

S2=SC4+RD+BYT 


As you can see, multiple choices for the status comparators are allowed, 
however, only one from each category should be used. For example, you 
should not set the status comparator to BYT+WRD, RD+WR, or SC3+SC4 
because these types of statuses would not happen simultaneously. 

Therefore, SI and S2 can equal the following: 


STATUS MNEMONIC TABLE 

SI = BYT + RD + TAR + SCO 

URD UR OVL SC1/UD 

SC2/UP 

SC3 

SC4 

SC5/SD 

SC6/SP 

SC7/CPU 

(Only one out of each category) 
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STATUS COMPARATOR BREAKDOWN 


14 

1 

13 

1 

12 11 

1 1 

10 

1 

9 

1 

8 

1 

7 

1 

- V/1 

-P" 

3 2 1 

1 1 

A31 

A30 

A29 A28 

A27 

A26 

A25 

A24 

0=SC0 

0=OVL 1 


1=SC1/UD 1=TAR | 

2=SC2/UP 0=WR 

3=SC3 1=RD 


4=SC4 


0=WRD 


5=SC5/SD 1=BYT 

6=SC6/SP 

7=SC7/CPU 


STATUS COMPARATOR BIT REPRESENTATION 

SC0=00000000 DC FF8F 
SC1/UD=00000010 DC FF8F 
SC2/UP=00000020 DC FF8F 
SC3=00000030 DC FF8F 
SC4=000000040 DC FF8F 
SC5/SD=00000050 DC FF8F 
SC6/SP=00000060 DC FF8F 
SC7/CPU=00000070 DC FF8F 
TAR=00000004 DC FFFB 
OVL=00000000 DC FFFB 
RD=00000002 DC FFFD 
WR=00000000 DC FFFD 
BYT=00000001 DC FFFE 
WRD=00000000 DC FFFE 
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Example of mode 2 display: 


>SET 

ES SETUP: SEE MANUAL FOR DETAILS... 

SET #X, #Y - SET ITEM X TO VALUE CORRESPONDING TO Y 

LD 0;SAV 0 LOAD/SAVE SETUP FOR CURRENTLY SELECTED USER 

SYSTEM: 

#1 USER = 0; [0,1] 

#2 RESET CHAR = $1A 

#3 XON, XOFF = $11, $13 

#4 TRACE MODE = 2; [0, 1, 2, 3] 

TERMINAL: 

#10 BAUD RATE = #14; [2=110, 5=300, 10=2400, 14=9600 
#11 STOP BITS =1; [1,2] 

#12 PARITY = 0; [0=NONE, 1=EVEN, 2=ODD] 

#13 CRT LENGTH = #24 

#14 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 

COMPUTER: 

#20 BAUD RATE = #7; [7=1200, 12=4800, 15=19200] 

#21 STOP BITS = 1 
#22 PARITY = 0 

#23 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 
#24 COMMAND TERMINATOR SEQUENCE = $0D, $00, $00 
#25 UPLOAD RECORD LENGTH = #32; [1 TO 127] 

#26 DATA FORMAT = 2; [0=INT, 1=MOS, 2=MOT, 3=SIG, 4=TEIC, 5=XTEK] 
#27 ACKNOWLEDGE CHAR = $06 


( continued ) 
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Example of mode 2 display: 


>DRT 

LINE 

ADDRESS 


DATA 

R/W 


FC 

DS 

sz 

ocs 

TIME 


#20 

FFF00506 

> 

00C0FFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

S 

#19 

FFF00508 

> 

206DFFFF 

R 

TAR 

SP 

01 

00 

0 

1.215 

S 

#18 

FFF0050A 

> 

041AFFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

S 

#17 

FFF21C72 

< 

FFFBFFFB 

W 

TAR 

SD 

01 

00 

0 

1.215 

S 

#16 

FFF21C74 

< 

00400040 

W 

TAR 

SD 

01 

10 

1 

1.215 

S 

#15 

FFF21C6E 

< 

FFF2FFF2 

W 

TAR 

SD 

01 

00 

0 

1.215 

S 

#14 

FFF21C70 

< 

04220422 

W 

TAR 

SD 

01 

10 

1 

1.215 

S 

#13 

FFF0050C 

> 

2268FFFF 

R 

TAR 

SP 

01 

00 

0 

1.215 

S 

#12 

FFF0050E 

> 

000CFFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

S 

#11 

FFF2041A 

> 

FFF2FFFF 

R 

TAR 

SD 

01 

00 

0 

1.215 

S 

#10 

FFF2041C 

> 

0422FFFF 

R 

TAR 

SD 

01 

10 

1 

1.215 

S 

#9 

FFF00510 

> 

4A29FFFF 

R 

TAR 

SP 

01 

00 

0 

1.215 

S 

#8 

FFF00512 

> 

0007FFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

S 

#7 

FFF2042E 

> 

FFFBFFFF 

R 

TAR 

SD 

01 

00 

0 

1.215 

S 

#6 

FFF20430 

> 

0040FFFF 

R 

TAR 

SD 

01 

10 

1 

1.215 

S 

#5 

FFF00514 

> 

6A02FFFF 

R 

TAR 

SP 

01 

00 

0 

1.215 

S 

#4 

FFF00516 

> 

6106FFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

S 

#3 

FFFB0047 

> 

44FFFFFF 

R 

TAR 

SD 

10 

01 

0 

1.215 

S 

#2 

FFF00518 

> 

4CDFFFFF 

R 

TAR 

SP 

01 

00 

0 

1.215 

S 

#1 

#0 

FFF0051A 

BREAK 

> 

0300FFFF 

R 

TAR 

SP 

01 

10 

1 

1.215 

$ 
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Trace Mode 3 

Trace mode 3 requires that the 40 conductor cable from the Pod be 
connected to the Logic State Probe connector on the front panel of the ES. 

Figure 13. Trace Mode 3 



Mode 3 would be selected to trace 32 address, 16 data, and all status lines. 
There are 6 LSA lines available for use in this mode. 

In this mode, the high address byte (A24-A31) is set up in the high 8 bits 
of the LSA register and the statuses are assigned as in modes 1 and 2. 
(Refer to page 8-31) 

SETUP 

To select mode 3 operation, type in: 


>set 4,3 


( continued ) 
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To view the selected mode of operation, type in: 


>SET (refer to line #4) 


Disconnect the Logic State Probe option and replace with the smaller cable 
that comes out of the 68020 pod. Connect the LSA pod to the 68020 pod 
face plate. 

OPERATION 

The ESI800 Event Monitor System is designed to use trace information to 
cause event actions. In the 68020, trace information is different depending 
on the selected mode (0,1, 2, or 3). 

The trace buffer contains 24 address bits, 16 data bits, 20 status bits, 16 
logic state bits, and 24 timer bits. For mode 3, these bits trace the 
following: 

Trace address bits: 


A0 through A23 on the trace card will trace 
A0 through A23 of the 68020 address bus. 


Trace data bits: 


DO through D15 on the trace card will trace 
D16 through D31 of the 68020 data bus. 
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Trace status bits: 


SO through S14 on the trace 

card will trace: 

Interrupt Pending 

(S14) 

Autovector 

(S13) 

Break 

(S12) 

Interrupt Line 2 

(S11) 

Interrupt Line 1 

(S10) 

Interrupt Line 0 

(S9) 

Bus Error 

<S8) 

Memory Access Violation 

(S7) 

Memory Write Violation 

(S7) 

Function code line 2 

<S6) 

Function code line 1 

<S5) 

Function code line 0 

(S4) 

(not used) 

(S3) 

TGT/OVL 

(S2) 

Read/Write 

(SI) 

Byte/Word 

(SO) 


Trace logic state bits: 


LSO through LS15 on the 

trace 

card will trace 

the following: 





68020 Address Bit 

31 

on 

LSI 5 


68020 Address Bit 

30 

on 

LS14 


68020 Address Bit 

29 

on 

LS13 


68020 Address Bit 

28 

on 

LS12 


68020 Address Bit 

27 

on 

LS11 


68020 Address Bit 

26 

on 

LS10 


68020 Address Bit 

25 

on 

LS9 


68020 Address Bit 

24 

on 

LS8 


| Read Modify Write Cycle 

(RMC) 

on LS7 

Cache Disable (CDIS) 

on 

LS6 



The remaining lines (LS0-LS5) come from the Logic State Analyzer pod 
option. To use these lines, plug the pod into the connector located on the 
68020 pod face plate. Use only the first 6 lines. 


( continued ) 
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When viewing the trace, all information will be in logical areas for easy 
viewing. For example, even though the logic state bits are tracing the 
upper data bits, these data bits will be displayed in the address field of the 
trace. The only item that is affected by this arrangement is the way the 
comparators are used for setting up the Event Monitor System. 


Examples 


When setting up the Event Monitor System, comparators are used to 
qualify the event actions. Please refer to page 8-2 for a complete 
description. The comparators used are: 

■ Two address comparators for use with the address area of 
the trace: AC1 and AC2 

■ Two data comparators for use with the data area of the 
trace: DC1 and DC2 

■ Two status comparators for use with the status area of the 
trace: SI and S2 

■ One logic state comparator for use with the lower data bits 
of the trace: LSA 

■ One count limit comparator for use with the internal count 
register: CL 

When assigning values to AC1 and AC2, single values and ranges are 
acceptable. DC 1, DC2 and LSA may have masked values. The CL register 
can be between 1 and $FFFF. 

To set up a comparator using the address bus, please remember to use the 
address comparators (AC1 and AC2) and the logic state comparators 
(LSA). For example, when trying to break on the address $12345678, use 
the following procedure: 
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>AC1=$345678 

>LSA=$12 DC $OOFF 

>UHEN AC1 AND LSA THEN BRK 

>RBK 


Notice the LSA comparator is used for the upper address bits (A24-A31) 
and AC1 is used for the lower address bits (A0-A23). The “DC $00FF” is 
the mask that will cause the Event Monitor System to ignore the 
information that is being traced in the remaining LSA bits. 

The following chart may aid in setting up the LSA comparator: 


LSI 5 

i 

LS14 

■ 

LS13 

I 

LS12 

i 

LS11 
■ 

LS10 

i 

LS9 

■ 

LS8 LS7 LS6 

l l l 

LS5 

i 

LS4 

i 

LS3 

i 

LS2 

i 

LSI 

i 

LSO 

■ 

1 

A31 

1 

i_ 

1 

A30 

1 

A29 

1 

A28 

A27 

1 

1 

A26 

1 

A25 

1 1 1 
A24 RMC CDC 

1 

1 

LS5 

1 

LS4 

1 

1 

LS3 

1 

LS2 

1 

LSI 

1 

LSO 

1 

.._. i 

1_!____ 


To setup the Event Monitor System to break on cache disable, use the 
following example: 


>LSA = 40 DC $FFBF 
>WHEN LSA THEN BRK 
>RBK 


The status comparators (SI and S2) may be set up with a variety of 
different conditions to further qualify your particular event action. The 
acceptable statuses are as follows: 


( continued ) 
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BYT or URD 
RD or UR 
TAR or OVL 

Any one of the function codes SCO 

SC1/UD 

SC2/UP 

SC3 

SC4 

SC5/SD 

SC6/SP 

SC7/CPU 

BER 

Any one of the interrupt priorities, IPO through IP7 
AV (autovector) 

IP (interrupt pending) 


When setting up a status comparator, the following examples are 
acceptable: 


S1=BYT 

S1=RD+OVL 

S2=BER+TAR 

S2=SC4+RD+BYT 

Sl=IP4 


As you can see, multiple choices for the status comparators are allowed, 
however, only one from each category should be used. For example, you 
should not set the status comparator to BYT+WRD, RD+WR, or SC3+SC4 
because these types of statuses would not happen simultaneously. 
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Therefore, SI and S2 can equal the following: 



STATUS MNEMONIC 

TABLE 

SI = BYT + RD + TAR 

+ SCO + BER + 

IPO + AV + IPO + AV + IP 

WRD WR OVL 

SC1/UD 

IP1 


SC2/UP 

IP2 


SC3 

IP3 


SC4 

IP4 


SC5/SD 

IP5 


SC6/SP 

IP6 


SC7/CPU 

IP7 

(Only one out of each category) 




STATUS 

COMPARATOR 

BREAKDOWN 


14 13 12 

11 10 

9 8 7 

6 5 4 

3 2 10 

i i i 

\ 1 / 

i 

\ i / 

i i i 

> 

< 

ii 

Q. 

II 

0=IP0 

1=BER 

0=SC0 

0=OVL | | 


1=IP1 


1=SC1/UD 

1=TAR | | 


2=IP2 


2=SC2/UP 

0=WR j 


3=IP3 


3=SC3 

1=RD j 


4=IP4 


4=SC4 

0=WRD 


5=IP5 


5=SC5/SD 

1=BYT 


6=IP6 


6=SC6/SP 



7=1 P7 


7=SC7/CPU 



( continued ) 
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STATUS COMPARATOR BIT REPRESENTATION 

IP=4000 DC BFFF 
AV=2000 DC DFFF 
IP0=0 DC FF1F 
I PI=00000200 DC F1FF 
IP2=00000400 DC F1FF 
IP3=00000600 DC F1FF 
IP4=00000800 DC F1FF 
IP5=00000A00 DC F1FF 
IP6=00000C00 DC F1FF 
IP7=OOOOOEOO DC F1FF 
BER=00000100 DC FEFF 
SC0=00000000 DC FF8F 
SC1/UD=00000010 DC FF8F 
SC2/UP=00000020 DC FF8F 
SC3=00000030 DC FF8F 
SC4=000000040 DC FF8F 
SC5/SD=000000050 DC FF8F 
SC6/SP=000000060 DC FF8F 
SC7/CPU=000000070 DC FF8F 
TAR=00000004 DC FFFB 
OVL=00000000 DC FFFB 
RD=00000002 DC FFFD 
WR=00000000 DC FFFD 
BYT=00000001 DC FFFE 
WRD=00000000 DC FFFE 
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Example of mode 3 display: 


>SET 

ES SETUP: SEE MANUAL FOR DETAILS... 

SET #X, #Y - SET ITEM X TO VALUE CORRESPONDING TO Y 

LD 0;SAV 0 LOAD/SAVE SETUP FOR CURRENTLY SELECTED USER 

SYSTEM: 

#1 USER = 0; [0,1] 

#2 RESET CHAR = $1A 

#3 XON, XOFF = $11, $13 

#4 TRACE MODE = 3; [0, 1, 2, 3] 

TERMINAL: 

#10 BAUD RATE = #14; [2=110, 5=300, 10=2400, 14=9600 
#11 STOP BITS = 1; [1, 2] 

#12 PARITY = 0; [0=NONE, 1=EVEN, 2=ODD] 

#13 CRT LENGTH = #24 

#14 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 

COMPUTER: 

#20 BAUD RATE = #7; [7=1200, 12=4800, 15=19200] 

#21 STOP BITS = 1 
#22 PARITY = 0 

#23 TRANSPARENT MODE ESCAPE SEQUENCE = $1B, $1B 
#24 COMMAND TERMINATOR SEQUENCE = $0D, $00, $00 
#25 UPLOAD RECORD LENGTH = #32; [1 TO 127] 

#26 DATA FORMAT = 2; [0=INT, 1=MOS, 2=MOT, 3=SIG, 4=TEK, 5=XTEK] 
#27 ACKNOWLEDGE CHAR = $06 
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Example of mode 3 display: 


>DRT 


LINE 

ADDRESS 


DATA 

R/W 


FC 

IPL 


LSA - 0 

TIME 


#20 

FFF21C5E 

< 

FFFB 

U 

TAR 

SD 

0 

IP 

%111111 

500.183 

MS 

#19 

FFF21C60 

< 

0040 

U 

TAR 

SD 

0 

IP 

%111111 

500.184 

MS 

#18 

FFF21C5A 

< 

FFF2 

U 

TAR 

SD 

0 

IP 

%111111 

500.184 

MS 

#17 

FFF21C5C 

< 

0422 

U 

TAR 

SD 

0 

IP 

%111111 

500.185 

MS 

#16 

FFF21C56 

< 

0000 

u 

TAR 

SD 

0 

IP 

%111111 

500.186 

MS 

#15 

FFF21C58 

< 

0000 

u 

TAR 

SD 

0 

IP 

%111111 

500.186 

MS 

#14 

FFF21C52 

< 

0000 

u 

TAR 

SD 

0 

IP 

%111111 

500.187 

MS 

#13 

FFF21C54 

< 

0000 

u 

TAR 

SD 

0 

IP 

%111111 

500.188 

MS 

#12 

FFF21C4E 

< 

0000 

u 

TAR 

SD 

0 

IP 

%111111 

500.188 

MS 

#11 

FFF21C50 

< 

0008 

u 

TAR 

SD 

0 

IP 

%111111 

500.189 

MS 

#10 

FFF21C4A 

< 

0000 

w 

TAR 

SD 

0 

IP 

%111111 

500.190 

MS 

#9 

FFF21C4C 

< 

00FE 

u 

TAR 

SD 

0 

IP 

%111111 

500.190 

MS 

#8 

FFF21C46 

< 

0000 

u 

TAR 

SD 

0 

IP 

X111111 

500.191 

MS 

#7 

FFF21C48 

< 

0003 

w 

TAR 

SD 

0 

IP 

%111111 

500.192 

MS 

#6 

FFF21C42 

< 

0000 

w 

TAR 

SD 

0 

IP 

%111111 

500.192 

MS 

#5 

FFF21C44 

< 

0003 

w 

TAR 

SD 

0 

IP 

%111111 

500.193 

MS 

#4 

FFF21C3E 

< 

0014 

u 

TAR 

SD 

0 

IP 

%111111 

500.193 

MS 

#3 

FFF21C40 

< 

oooc 

u 

TAR 

SD 

0 

IP 

%111111 

500.194 

MS 

#2 

FFF21C3A 

< 

0000 

w 

TAR 

SD 

0 

IP 

%111111 

500.195 

MS 

#1 

#0 

FFF21C3C 

BREAK 

< 

0001 

w 

TAR 

SD 

0 

IP 

%111111 

500.195 

MS 
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Counting Events 

Registers: 

Value Type - 16 bit integer 

CL 


CL. 1 


CL.2 


CL.3 


CL.4 


CL=<EXP> 

CL<.group>=<EXP> 


Events: 


CNT 


RCT 


TOC 



Events can be defined to count bus cycles selectively. There is one 
hardware counter and there are four count registers, one register for each 
group. Each group has its own count limit register (CL). The Event 
Monitor System has only one counter. The hardware counter is 
automatically loaded with the count limit register for group 1 when 
entering run mode. 

The count, CNT, action decrements the hardware counter. When the count 
reaches zero, the CL event becomes true. If all other conditions specified 
in the WHEN/THEN clause are satisfied, the appropriate action is taken. 

Whenever the reset count, RCT, action is specified, the count comparator 
value for the specified group is loaded into the hardware counter. When 
switching groups, the current value of the hardware counter is passed 
along as a global count value unless a RCT action is specified in the same 
list of events that causes the group switch. 
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The toggle count, TOC, command provides a way to turn counting on and 
off. When a TOC event is detected, the count is toggled to the opposite 
state, either on or off. You can specify an event that starts and stops the 
counter each time it is detected or specify any number of events that toggle 
the counter on and off. 

The current value of the counter cannot be read. You can only detect 
when you have reached a limit. 

This table describes the count conditions immediately before an after a 
group change. 


Previous 

Group 

i 

| Nothing 
j Specified 

New Group 

i i 

i i 

i cnt i 

TOC 

i 

i 

i 

Nothing 

j No cycles 

j Count only | 

Count nothing 

i 

Specified 

j counted 

j qual'd cycles j 

until first TOC 

i 

CNT 

| No cycles 

| Count only | 

Count nothing 

i 


| counted 

j qual 1 d eyeles j 

until first TOC 

i 

TOC 

| No cycles 

| Count only | 

Count nothing 

i 

(Not counting) 

j counted 

j qual 1 d eyeles j 

until first TOC 

i 

TOC 

j No cycles 

| Count only | 

Count all 

i 

(Tracing) 

| counted 

| qual'd cycles j 

_ i _ _ i 

until first TOC 

i 

i 

ii i i ----1 | 
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This table describes initial count conditions (always group 1). 


Action 

ll 

Count 

Specified 

II 

Condition 

Nothing 

II 

Count 


II 

nothing 

CNT 

ll 

Count only 


ll 

Qual'd CNT events 

TOC 

ll 

Count nothing 


ll 

until TOC event 


Examples 


Count the times that the specified data are written to a specific address. 
Break if the data are written 20 times. 


>CL=#20 

>S1=WR 

>AC1=4020; DC1=$XXF3 
>WHEN AC1 AND DC1 AND Si THEN CNT 
>WHEN CL THEN BRK 
>RBK 
R> 


( continued ) 
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To cause a break to occur after $400 writes have lapsed: 


si = WR 
CL = 400 

WHEN SI THEN CNT 
WHEN CL THEN BRK 


Look for a read from a specific I/O port. After it is found go to group 2, 
load the group 2 counter register value into the hardware counter and set a 
group 2 address comparator to count every bus cycle (all addresses). Break 
after 100 bus cycles. 


>AC1 =I IOport 
>S1=RD 

>WHEN AC1 AND Si THEN GRO 2, RCT 
>CL.2=#100 
>AC1.2=0 TO -1 
>2 WHEN AC1 THEN CNT 
>2 WHEN CL THEN BRK 
>RBK 
R> 
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Trigger Signal 

The trigger signal is an output that is available from the BNC connector 
labelled TRIG on the back panel of the ESI800 chassis and from pin 19 of 
the optional LSA pod. When a TGR event is detected, the trigger signal is 
asserted, and remains so for the duration of the specified bus cycle. If a 
trigger event is specified for more than one consecutive bus cycle, the 
signal stays high for the duration of the consecutive bus cycles. 

The trigger signal can be used as a pulse output for triggering other 
diagnostic equipment. It can also be used in conjunction with a 
counter/timer for timing subroutines. 


Examples 


Trigger a scope when reading data from a UART. 


>AC1 = 1 DATA_PORT 
>S1=RD 

>WHEN AC1 AND Si THEN TGR 


Determine the duration of a subroutine using the trigger pulse. The trigger 
pulse can be the input to a counter/timer or a scope. The duration of the 
subroutine can be determined from the pulse width displayed on the scope 
or the counter/timer readout. 


>AC1=2500 

>AC1.2=AC1+38E 

>DC1.2=XXXX 


Start of subroutine 
End of subroutine 
Detect any data pattern 


>WHEN AC1 THEN TGR, GRO 2 
>2 WHEN DC1 THEN TGR 
>2 WHEN AC1 THEN GRO 1 
>RUN 
R> 


Go to Group 2 when subroutine is entered 
Trigger during all cycles while in Group 2 
Go back to Group 1 when last instruction 
in subroutine is executed. 


( continued ) 
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Special Interrupts 


Registers: 


SIA 

Value Type - 32 Bit Integer 

Events: 


FSI 



The force special interrupt action, FSI, provides a way to jump to a 
specified address when a specific event is detected. 

The special interrupt address register, SIA, should be set prior to entering 
run mode if you are using the FSI event. It defines the address your 
program vectors to when the FSI is executed. 

When an FSI event is detected, an Ifsi active! message is displayed on the 
screen. You may also see some unusual cycles in the trace memory at the 
address where the FSI occurred. These are internal cycles that get traced 
as the execution address is changed. They are not purged from the trace 
memory because of the need for speed when executing an FSI. 

The FSI event can be used as a fast way to make a patch to your code. It is 
also used to write soft shutdown routines for machinery that cannot be 
halted using a simple breakpoint. 

The FSI routine residing at the SIA address should terminate with a return 
from exception (RTE) instruction. Execution will resume at the address 
immediately following the instruction that caused the FSI. If this is a soft 
shutdown, you will probably define a breakpoint at the RTE instruction. 
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Examples 


Make a patch using overlay memory. 


>MAP 1000 

>AC1=8F36 

>UHEN AC1 THEN FSI 

>SIA=1000 

>ASM SIA 

Single 

line assembler - patch code 


can be 

assembled here. 

>RUN 



R> 




Assume the program needs to break at a certain address, but the machine 
cannot be turned off until a soft shutdown routine is executed. Set SI A to 
the address of the soft shutdown routine. Use an FSI action at the break 
address, then set a breakpoint at the end of the soft shutdown routine. 


>SIA='SHUT_down 
>AC1=$7F4E2 
>AC2='SHUT_down + 4E 
>WHEN AC1 THEN FSI 
>WHEN AC2 THEN BRK 
>RBK 
R> 
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Changing Event Groups 

The four event groups provide a way to detect sequential events. When 
emulation is entered, event monitoring always begins in group 1. The 
example below describes a common use of the EMS group structure. 

You may wish to trace a subroutine after it has been called by module A or 
module B, but not if it has been called from modules C, D, or E. In this 
case, you would define the address comparators in group 1 to the address 
ranges of modules A and B. When either of these modules is encountered, 
switch to group 2 and look for the subroutine. After tracing the 
subroutine, switch back to group 1. 


>'Module_A =1240 LEN 246 
>'Module_B =8750 LEN 408 
> 1 Sub_X =8934 LEN 56 

>AC1='Hodule_A 

>AC2='Module_B 

>WHE AC1 OR AC2 THE GRO 2 

>AC1.2='Sub_X 

>2 WHEN AC1 THE TRC 
>2 WHE NOT AC1 THE GRO 1 
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The TRC/TOT and CNT/TOC actions interact in a specific way when 
event groups are switched. The following state transition tables describe 
the actions taken when each of the different event combinations are 
specified. 


NEW GROUP 


PREVIOUS 

TOT 

GROUP 

Nothing 

specified 

TRC 

TOT 

Nothing 

specified 

| Trace all 
| eyeles 

1 

Trace only 
qual'd cycles 

Trace until 
first TOT 

TRC 

1 

| Trace all 
| eyeles 

1 

Trace only 
qual'd cycles 

No Trace until 
first TOT 

TOT NOT 

TRACING 

1 

| Trace all 
| eyeles 

1 

Trace only 
qual'd cycles 

No Trace until 
first TOT 

TOT 

TRACING 

1 

| Trace all 
| eyeles 

Trace only 
qual'd cycles 

Trace until 
first TOT 


NEW GROUP 


PREVIOUS 

GROUP 

Nothing 

specified 

TRC 

TOT 

Nothing 

specified 

| No cycles 
| counted 

1 

Count only 
qual'd cycles 

No count until 
first TOC 

CNT 

| No cycles 
| counted 

1 

Count only 
qual'd cycles 

No count until 
first TOC 

TOC OFF 

1 

| No cycles 
j counted 

1 

Count only 
qual'd cycles 

No count until 
first TOC 

TOC ON 

| No cycles 
| counted 

Count only 
qual'd cycles 

Count until 
first TOC 


( continued) 
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Shortcuts for Setting Up 

This information is intended as a helpful guide to aid in setting up the 
Event Monitor System. Please read all of this information before using it. 
You can use the examples as is or you may find another combination of 
commands to accomplish your task. 

These examples assume you are familiar with macros, (page 5-117) and, 
for repetitive use, know how to save macros to the EEPROM (page 5-25). 
Though the following macros use GD0 and GDI, you may use any of the 
general purpose registers (page 5-87). 

MODEO 

Mode 0 is relatively easy to set up when using the Event Monitor System. 
To set up the address comparators, simply use the lower 24 bits of the 
address. To set up the data comparators, use the following macro: 


_1=DC1=GD0» #16 

GDO=XXXXXXXX <32 bit data pattern you are using) 
1 


Set GD0 to a 32 bit data pattern and execute macro #1. The data 
comparators will only utilize the upper 16 bits. This macro will shift the 
data pattern to the right 16 places and place the new value into DC1. 

The Event Monitor System can now be set up. For example: 


>UHEN DC1 THEN BRK 


MODE 1 

Mode 1 uses the LSA comparator and the data comparators to set up a full 
32 bit data value. Use the following macro to set up a data comparator: 
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_1=LSA=GD0;DC1=GD0»#16 

GDO=XXXXXXXX (32 bit data pattern you are using) 
1 


Set GDO to a 32 bit pattern and execute macro #1. The data comparator 
will utilize the upper 16 bits and the LSA comparator will utilize the lower 
16 bits. 

The Event Monitor System can now be set up. For example: 


>WHEN DC1 AND LSA THEN BRK 


MODE 2 

(Please refer to Mode 1 for setting up the data comparator.) 

To set up the address comparator, you will need to use an address 
comparator and a status comparator. 


_1=AC1=GD1;S1=((GD1»#17)&$7F80) DC $S07F 
GD1=XXXXXXXX (32 bit data pattern you are using) 
1 


This macro will place the lower 24 bits into AC1. Next, GDI will be 
shifted 17 (decimal) times to align adddress bits 24-31 to SI bits 7-14. 
Next, it is “ANDED” with $7F80 to zero out the lower bits. Finally, a 
don’t care mask is added so the SI comparator will not expect to include 
bits 0-6 in the event comparison. This manipulated information will be 
placed into SI. 

The Event Monitor System can now be set up. For example: 


>WHEN AC1 AND SI THEN BRK 


( continued) 
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To extend the address to a range, after the macro has been executed, use 
the following syntax: 


AC1=AC1 LEN XXXXXX 


You will not be able to extend the range to the upper 8 bits since they are 
residing in a status comparator. Ranges are not allowed in the status 
comparators. 

To include any of the other status bits (i.e. BYT/WRD or TAR/OYL), 
after the macro has been executed, use the following syntax: 


S1=S1+BYT 

S1=S1+TAR+IP3 


MODE 3 


_1=AC1=GDO;LSA=((GDO»#16)&$FFOO) DC $FF 
GD0=XXXXXXXX (32 bit data pattern you are using) 
1 


This macro will place the lower 24 bits into AC1. Next, GD0 will be 
shifted 16 (decimal) times to align adddress bits 24-31 to LSA bits 8-15. 
Next, it is “ANDED” with $FF00 to zero out the lower bits. Finally, a 
don’t care mask is added so the LSA comparator will not expect to include 
bits 0-7 in the event comparison. This manipulated information will be 
placed into the LSA comparator. 

The Event Monitor System can now be set up. For example: 


>WHEN AC1 AND LSA THEN BRK 
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To extend the address to a range, after the macro has been executed, use 
the following syntax: 


AC1=AC1 LEN XXXXXX 


You will not be able to extend the range to the upper 8 bits, since they are 
residing in an LSA comparator. Ranges are not allowed in LSA 
comparators. 
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ES LANGUAGE MNEMONICS 


ES Language Commands 


Mnemonic 

Description 

Page 

> 

emulation pause mode prompt 

4-27 

R> 

emulation run mode prompt 

4-27 

IRETURNI 

Return 

4-6 

/ 

repeat previous command line 

4-7 


statement separator 

4-6 

* 

repeat command 

4-6 

CTRL Q 

start screen scrolling (can be changed) 

4-31 

CTRLS 

stop screen scrolling (can be changed) 

4-31 

CTRL X 

delete line 

4-31 

CTRL R 

reprint current line 

4-31 

CTRL Z 

reset the emulator 

4-31 

ESC ESC 

escape transparent 

4-31 

$ 

hexadecimal 

4-11 
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Mnemonic 

Description 

Page 

# 

decimal 

4-11 

% 

binary 

4-11 

\ 

octal 

4-11 

= 

equals 

4-12 

0 

parentheses 

4-8 

@ 

indirection 

4-9 

* 

multiplication or repeat 

4-17 

/ 

division 

4-17 

+ 

addition 

4-17 

- 

subtraction 

4-17 

- 

negation 

4-16 

& 

bitwise AND 

4-17 

A 

bitwise OR 

4-17 

« 

shift left 

4-17 

» 

shift right 

4-17 

t 

inverse, bitwise NOT 

4-17 


memory block attribute 

6-15 


increment Memory Mode address 

6-46 


execute macro 2 

5-110 

9 

decrement Memory Mode address 

6-46 

9 

execute macro 1 

5-110 

9 

help menu 

4-20 

9 

error query 

4-7 


define/execute macro 

5-88 

9 

symbol definition (single quote) 

4-10 
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Mnemonic 

Description 

Page 


•B 

dot operator, byte mode 

4-28 

•W 

dot operator, word mode 

4-28 

.L 

dot operator, long word mode 

4-28 

A(0-6) 

address register (0-6) 

5-69 

ABS 

absolute value 

4-17 

AC1, AC2 

address comparators 1 and 2 

7 - 3 , 8-3 

AND 

logical event AND 

4-16 

ALL 

status constant 

5-63 

ASM 

line assembler 

6-34 

BAS 

display base value 

5-79 

BFMT 

bus error register 

5-75 

BMO 

block move 

6-24 

BRK 

break 

7 - 15 , 8-11 

BTE 

bus timeout enable switch 

5-12 

BUS 

display status of lines 

6-82 

BYM 

byte mode 

4-28 

BYT 

byte access status 

7 - 5 , 8-4 

CAAR 

cache address (68020) 

5-70 

CACR 

cache control (68020) 

5-70 

CAS 

continuous address strobe switch 

5-13 

CCT 

serial port control 

5-35 

CDS 

cache disable switch (68020) 

5-14 

CES 

clear WHEN/THEN statements 

7 - 14 , 8-10 

CL 

count limit 

7 - 8 , 8-4 

CLK 

read target system clock 

6-79 

CLM 

clear memory map 

5-62 
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Mnemonic 

Description 

Page 


CLR 

clear microprocessor data registers 

5-76 

CLT 

clear trace memory (68020) 

5-102 

CMC 

clear macros 

5-121 

CNT 

count event 

7 - 20 , 8-54 

COM 

Communication with target 

5-47 

CPU 

CPU space 

5-63 

CPY 

copy switch 

5-15 

CRC 

target cyclic redundancy check 

6-80 

CYC 

cycle (68010) 

5-72 

D(0-7) 

data registers (0-7) 

5-69 

DB 

display memory block 

6-17 

DBP 

disable bus error switch 

5-16 

DC 

don’t cares 

4-11 

DC1, DC2 

data comparators 1 and 2 

7 - 4 , 8-3 

DEL 

delete symbol/section 

5-132 

DES 

display WHEN/THEN statements 

7 - 12 , 8-8 

DFB 

default base register 

5 - 70 , 5-85 

DFC 

destination function code register 

5-69 


(68010) 


DIA 

display ASCII character string 

5-51 

DIB 

bus error register 

5 - 73 , 5-75 

DIS 

display disassembled memory 

6-39 

DM 

display memory map 

5-54 

DNL 

download 

5-38 

DOB 

bus error register 

5 - 73 , 5-75 
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Mnemonic 

Description 

Page 


DR 

display microprocessor registers 

5-76 

DRT 

display raw trace memory 

5-94 

DST 

display raw trace memory 

5-108 

DT 

disassemble trace memory 

5-103 

DTB 

disassemble trace memory backward 

5-116 

DTF 

disassemble trace memory forward 

5-116 

ECS 

external cycle start switch (68020) 

5-17 

END 

exit line assembler 

4-29 

FA 

bus error register 

5 - 73 , 5-75 

FIL 

fill memory with constant data 

6-21 

FIN 

find data in range 

6-19 

FMT 

bus error register 

5-73 

FSI 

force special interrupt 

7 - 25 , 8-58 

FST 

fast interrupt enable switch 

5-18 

FTO 

fast bus timeout switch 

5-20 

GDO-7 

general purpose data registers (0-7) 

5 - 70 , 5-87 

GRO-7 

general purpose range registers (0-7) 

5 - 70 , 5-89 

GRO 

event monitor system group 

7 - 27 , 8-61 

IDX 

repeat index register 

5 - 70 , 5-113 

IIB 

bus error register 

5-73 

ILG 

illegal memory access attribute 

5-56 

IM 

introspective mode switch 

5-21 

IP(0-7) 

interrupt levels 

7 - 5 , 8-4 

IPS 

bus error register 

5-75 

IR(1-16) 

bus error registers 

8-4 

IRA 

internal range 

4-11 
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Mnemonic 

Description 

Page 


IR(A-G) 

bus error registers 

5-75 

ISP 

interrupt stack pointer 

5-70 

LD 

load EEPROM data 

5-27 

LDV 

load vectors 

6-9 

LEN 

length 

4-11 

LIM 

repeat limit register 

5-70, 5-113 

LOV 

load overlay memory 

5-65 

LSA 

Logic State Probe comparator 

7-4, 8-3 

LST 

decrements address in memory mode 

6-46 

LWM 

long word mode 

6-15 

MAC 

display macros 

5-118 

MAP 

define overlay memory map 

5-55 

M 

enter memory mode 

6-42 

MMD 

access status register 

5-70, 5-81 

MMP 

memory mode pointer 

5-70, 5-83 

MMS 

memory mode status 

5-70,5-81 

MOD 

modulo 

4-17 

MSK 

bus error register (68010) 

5-73 

MSP 

master stack pointer (68020) 

5-70 

NOT 

logical event NOT 

4-15 

NXT 

increment address in memory mode 

6-46 

ocs 

operand cycle start 

5-17 

OFF 

disable switches 

5-9 

ON 

enables switches 

5-9 

OR 

logical event OR 

4-16 
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Mnemonic 

Description 

Page 


OVE 

overlay memory enable 

5 - 63 , 5-70 

OVL 

overlay memory access 

7 - 5 , 8-4 

OVO 

MMS/MMD attribute 

5-81 

OYS 

overlay memory speed 

5-67 

PC 

program counter register 

5 - 69 , 5 - 73 , 

5-75 

PPT 

peek/poke trace switch 

5-22 

PUR 

clear symbolic memory 

5-133 

R(0-14) 

bus error registers 

5-73 

RBK 

run with breakpoints 

6-5 

RBV 

load reset vectors and run breakpoints 

6-5 

RCT 

reset count limit 

7 - 20 , 8-54 

RD 

read access status 

7 - 5 , 8-4 

RET 

execute line feed and return 

5-136 

REV 

display firmware revision 

5-135 

RNV 

run with new vectors 

6-5 

RO 

read only attribute 

5-56 

RST 

reset target system 

6-14 

RUN 

run emulation 

6-5 

RW 

read/write attribute 

5-55 

SI, S2 

status comparators 1 and 2 

7 - 5 , 8-4 

SAV 

save EEPROM data 

5-25 

SBA 

bus error register 

5-75 

SC(0-7) 

space code status 

7 - 5 , 8-4 

SD 

supervisor data 

5-63 

SEC 

display section 

5-129 
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Mnemonic 

Description 

Page 


SET 

set/display system parameters 

5-3 

SF(0-3,10-17, 
20,40-49) 

special functions 

6-50 

SEC 

source function code register (68010) 

5-69 

SIA 

special interrupt address 

7 - 25 , 8-60 

SLO 

slow interrupt enable switch 

5-18 

SP 

supervisor program 

5-63 

SPD 

view bus speed info switch 

5-23 

SR 

status register 

5 - 69 , 5 - 73 , 

5-75 

SSP 

supervisor stack pointer register 

5-69 

SSW 

bus error register 

5 - 73 , 5-75 

STA 

search raw trace for address 

5-114 

STD 

search raw trace for data 

5-114 

STS 

search raw trace for status 

5-114 

STP 

step and stop 

6-8 

SYM 

display symbols 

5-128 

SZ 

value display 

4-28 

TAD 

tri-state address switch 

5-24 

TAR 

target access 

5-113 

TCT 

terminal control 

5-34 

TGO 

MMS/MMD attribute 

5-81 

TGR 

enable trigger output 

7 - 24 , 8-58 

TGT 

target system memory attribute 

5-56 

THE 

then 

7 - 2 , 8-2 

TIM 

Select Timer Frequency 

5-107 
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Mnemonic 

Description 

Page 


TO 

to 

4-11 

TOC 

toggle counting 

7 - 21 , 8-55 

TOT 

toggle trace memory 

7 - 17 , 8-12 

TRA 

transparent mode 

5-32 

TRC 

trace event 

7 - 17 , 8-12 

TST 

test register for repeats 

5 - 70 , 5-91 

UD 

user data 

5-63 

UP 

user program 

5-63 

UPL 

upload 

5-43 

UPS 

upload symbols 

5-45 

USP 

user stack pointer register 

5 - 69 , 5-70 

VBL 

verify block data 

6-22 

VBM 

verify block move 

6-27 

VBR 

vector base register (68010/20) 

5 - 69 , 5-70 

VFO 

verify overlay memory 

5-66 

VFY 

verify serial data 

5-42 

VM 

valid memory address status 

7 - 5 , 8-4 

VP 

valid peripheral address status 

7 - 5 , 8-4 

WAI 

wait 

6-11 

WDM 

word mode 

4-27 

WHEN/THEN 

WHEN/THEN Statements 

7 - 2 , 8-2 

WR 

write access status 

7 - 5 , 8-4 

WRD 

word access status 

7 - 5 , 8-4 
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Mnemonic 

Description 

Page 

X 

don’t care 

4-11 

X 

exit memory mode 

6-45 

XRA 

external range 

4-11 
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ERROR MESSAGES 

Error Messages 

Following is a list of error messages that the Emulator may display due to 
target-type errors. 

CRCERROR IN 

BOOT 

Indicates a PROM error on the memory 
control board, U32 located in the Emulator 
chassis has a PROM malfunction. 
Addresses 1FE000 to 1FFFFF (level 1) or 
E000 to FFFF (for testing) on the 6809 side. 

CRCERROR IN 
DISASSEMBLER 

Indicates a PROM error on the Emulator 
card, U72. Addresses 1C000 to 1FFFF 
(level 1) or C000 to FFFF (for testing) on 
the 6809 side. 

CRC ERROR IN ESL 

Indicates a PROM error on the Emulator 
card, located in the Emulator chassis. 
Addresses 4000 to FFFF on the 6809 side. 

EMULATOR CRC 
ERROR 

Indicates a PROM error on the Emulator 
card. Addresses 8000 to FFFF on the 
680XX side. 


NOTE: A cyclic redundancy check (CRC) 
error message displays whenever an internal 
hardware error to the Emulator has 
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MEMORY ACCESS 
VIOLATION 


MEMORY WRITE 
VIOLATION 


PROCESSOR HUNG 


occurred. A PROM that is not firmly 
seated or has one of its legs folded under 
may cause a CRC error. If after checking 
for this a PROM malfunction still exists, 
call the factory, as this may indicate a 
serious problem. 

Indicates that the target program has 
attempted to access an area of target that is 
mapped illegal (ILG). 

DM will help determine which areas are 
mapped as illegal. 

DRT will help determine where the 
program was making the access. 

Indicates that the target program has tried 
to write to the RAM overlay in an area that 
is mapped read only (RO). 

DM will help determine which areas are 
mapped read only. 

DRT will help determine which address the 
program was writing to. 

Indicates that the Emulator is forcing a 
break (a single step, stopping, or a 
breakpoint), but the target processor is not 
responding to the 6809. In the Emulator, 
this means the “run to pause” routine was 
interrupted. Issue a reset (CTRL-Z) and 
look at the RAW trace (DRT). 

In the 68000/08/10, a PROCESSOR- 
HUNG error can occur if an odd value is 
present in the SSP or VBR when the break 
occurred. When the Emulator goes into run 
mode, the SSP is forced to an even value. 
In the 68010 and 68020, VBR will also be 
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UNUSED VECTOR 
XXX 


WARNING - NO 
TARGET VCC 


forced to an even value. If the program 
forces the VBR register to an odd address 
when the Emulator attempts to go into 
pause mode, a PROCESSOR HUNG error 
occurs. However, if the stack register in the 
68020 has been changed to an odd value 
during run, an UNUSED VECTOR 010 
message may display after a couple of single 
steps (see below). 

Indicates a processor-generated error that 
the Emulator is unable to correct. The 
Emulator returns control to the user with a 
0 prompt to wait for further commands. 
The number refers to the vector offset 
listed in the Exception Vector Assignments 
from Motorola. Please refer to the 
appropriate Motorola Microprocessor User’s 
Manual. 

Indicates that there is no target power. 
Target power is checked before data 
strobes; therefore data strobes may or may 
not be present. The operating system 
prompt returns after this message is 
displayed, permitting user input. 
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Data Strobe Messages 

These messages display whenever the data strobes are halted for more than 
220 ms, making the user aware of status conditions on the target system. 


BUS TIMEOUT 
WAITING FOR 
DSACK 


BUS TIMEOUT 
WAITING FOR 
DTACK 


DOUBLE BUS 
FAULT 


(68020) Indicates that the present bus cycle 
has not been terminated. Possible causes 
include program execution accessing non¬ 
existent memory or address space. 

This message does not necessarily indicate 
an error. If the bus cycle is terminated by 
the target after the message is displayed, 
program execution will continue. 

In the event the target does not terminate 
the cycle, use CTRL Z, then examine raw 
trace (using DRT) to determine the fault. 

(68000/08/10) Indicates that the present 
bus cycle has not been terminated. Possible 
causes include program execution accessing 
nonexistent memory or address space. 

This message does not necessarily indicate 
an error. If the bus cycle is terminated by 
the target after the message is displayed, 
program execution will continue. 

In the event the target does not terminate 
the cycle, use CTRL Z, then examine raw 
trace (using DRT) to determine the fault. 

Indicates that the processor is halted from 
the processor side due to a double bus fault. 
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(68008) Double bus faults may be caused 
by: 


EXCESSIVE DMA 
TIME 


NO BUS ACTIVITY 


NO TARGET CLOCK 


1. Stack memory in non- 
valid memory space - no 
DTACK returned. 

2. Stack memory in valid 

memory but set to an ODD 
address: example: 

SSP=7FFFF should be SSP 
= 80000 or 7FFFE 

3. Attempting to access non- 
valid memory. 

Indicates that the target bus request, bus 
grant, or bus grant acknowledge signals 
have been asserted for longer than 150 ms. 

This message does not necessarily indicate 
an error. If the other bus master releases 
the bus after this message is displayed, 
program execution will continue. 

In the event this condition continues in the 
target, use CTRL Z to break emulation. 

Indicates no data strobe activity. Possible 
causes include the processor executing a 
STOP instruction or, in a 68020 system, the 
processor is executing out of cache. 

This message indicates a status and does not 
necessarily indicate an error. 

Indicates that there is no clock present at 
the probe tip. The target system is expected 
to provide a clock signal. 
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NO TARGET VCC 


PROCESSOR 
EXECUTING STOP 
INSTRUCTION 

TARGET BUS 
ERROR IS LOW 


TARGET HALT 
ASSERTED 


TARGET RESET 
ASSERTED 


B-6 


Indicates that there is no VCC present at the 
probe tip. The target system is expected to 
provide VCC via the probe tip. Check the 
VCC pin for power. 

The probe tip power is checked before data 
strobes. Therefore, data strobes may or 
may not be present as well as target power. 

For the 68000/08/10 processor only. See 
NO BUS ACTIVITY. 


Indicates that a bus error signal on the 
probe tip is held low by the target system. 

NOTE: This error requires a solid low from 
the target, whereas BUS ERROR and 
DOUBLE BUS FAULT both require the bus 
error pin to be negated. 

Indicates that the halt has been asserted 
from the target side for longer than .5 
seconds. 

Indicates that the target reset has been 
asserted for longer than about .5 seconds. 
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SERIAL DATA FORMATS 


In order to download a program into target memory, the ES 1800 needs 
some way to receive this data in an intelligible format. This Appendix 
describes the downloading formats which the ES 1800 understands. 
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MOS Technology Format 

Figure 14. Specifications for MOS Technology Data Files Copyright 1983 , 
Data I/O Corporation; reprinted by permission. 


INPUT 

DATA RECORD END-OF-FILE RECORD 



START CHARACTER 


BC = Byte Count. The hexadecimal number of data 
bytes in the record 


AAAA = Address of first data byte in record. AAAA 
in hexadecimal notation only 


HH = One data byte in hexadecimal notation 


CCCC = Checksum. Two byte binary summation of 
preceding bytes in record (including address, and 
data bytes) in hexadecimal notation. 


This space can be used for line feed, carriage return or 
comments. 

(Beginning of next record) 


LEGEND 


= Start Character 

BC = Byte Count (BC > 00 in Record, BC = End of File Record) 

AAAA = Address Field 

CCCC = Checksum of Record 

RRRR = Record Count 

HH = Two Hexadecimal Digits (0:9, A:D) 



START CHARACTER 

Byte Count. BC = 00 in End of File Record 

Record Count 

Checksum 


OUTPUT 


1) Number of bytes per record is variable. See Table 3.1 

2) Each line ends with nonprinting line feed, carriage return 
and nulls. 


2 Hex Characters = 1 byte - 


BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAMHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAMHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCCC 

BCRRRRCCCC 
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Motorola Exorcisor Format 

Figure 15. Specifications for Motorola Exorciser/ 16-BM Data Files/ 
Copyright 1983, Data I/O Corporation; reprinted by permission. 


INPUT 

DATA RECORD SIGN ON RECORD OPTIONAL 



START CHARACTERS 


BC = Byte Count. The number of data bytes plus 3(1 for 
checksum and 2 for address) in hexadecimal notation 

AAAA = Address of first date byte in record. AAAA in 
hexadecimal notation only 


HH = One data byte in hexadecimal notation 



CC = Checksum. One's complement of binary summation 
of preceding bytes in record (including byte count, 
address and data bytes) in hexadecimal notation 

This space can be used for line feed, carriage return or 
comments 

(Beginning of next record) 


LEGEND 


50 = Optional Record Start Characters 

51 = Start Characters 

BC = Byte Count 

[(Date Butes/Record + 3] 

AAAA = Address of First Data Byte 
HH = Two Hexadecimal Digits (0-9, A-F) 

CC = Checksum of Record (one byte) 


S SO Start characters of sign on record. Except 
0 for start characters SO record has same format as 
^ data record 

END OF FILE RECORD 



START CHARACTERS 

Byte Count BC = 03 in End of File Record 

Address 

Checksum 


(OUTPUT 


1) Number of bytes per record is variable See Table 31 

2) Each line ends with nonprinting line feed, carriage return 
and nulls 

3) Sign on record may precede data 

2 Hex characters 1 byte —y Data Records ■ 


S1BCAAAAHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHHCC 

S9BCAAAACC 
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Intel Intellec Format 


Figure 16. Specifications for Intel Intellec/8/MDS Data Files/ 
Copyright 1983 , Data I/O Corporation; reprinted by permission. 


DATA RECORD 


END OF FILE RECORD 


START CHARACTER 


START CHARACTER 


B BC = Byte Count. The hexadecimal number of data bytes 

C in the record 


B Byte Count. BC = 00 in End of File Record 
C 


AAAA = Address of first date byte in record. AAAA in 
hexadecimal notation only 


TT = Record Type (00) 


H HH = One data byte in hexadecimal notation 


TT Record Type (01) 



CC = Checksum. Negation (two’s complement) of binary 
summation of preceding bytes in record (including byte 
count, address, and data bytes) in hexadecimal notation 

This space can be used for line feed, carriage return or 
comments 


OUTPUT 


1) Number of bytes per record is variable. See Table 3.1. 

2) Each line ends with nonprinting line feed, carriage return 
and nulls 


2 Hex characters 1 byte - 


: Start Characters 
; Byte Count (Date Bytes/Record) 

; Address Field 
: Record Type 

; One Hexadecimal Digit (0-9, A-F) 
; Checksum of Record 


BCAAMTT 


C- 
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Signetics/Absolute Object File Format 

Figure 17. Specifications for Signetics/Absolute Object Data Files 
Copyright 1983, Data I/O Corporation; reprinted by permission. 


INPUT 

DATA RECORD END OF FILE RECORD 



START CHARACTER 


AAAA - Address of first date byte in record. AAAA in 
hexadecimal notation only 


BC * Byte Count. The hexadecimal number of data bytes 
in the record 

AC - Address Check. Every byte is exclusive O Red with 
the previous byte, then rotated left one bit. 


HH * One data byte in hexadecimal notation 


DC - Data Check. Every byte is exclusive O Red with the 
previous byte, then rotated left one bit. 

, This space can be used for line feed, carriage return or 
comments 

.(Beginning of next record) 


LEGEND 

• Start Characters 
AAAA « Address Field 

BC - Byte Count (Date Bytes/Record) 

AC = Address Check. Checksum of address and byte count 

HH * Two Hexadecimal Digits (0-9, A-F) 

DC = Data Check. Checksum of data in record 
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Tektronix Hexadecimal Format 

Figure 18. Tekhex/Copyright 1983, Tektronix; reprinted by permission 


INPUT 

DATA RECORD ABORT RECORD 



/ = Start Character 


AAAA = Address of first date byte in record, 
(hexadecimal notation) 


BC = Byte Count. The hexadecimal number of data bytes 
in the record 

CC = Checksum. Eight bit sum of the four bit 
hexadecimal values of the six digits that make up the 
address and byte counts (hexadecimal notation) 


HH = One data byte in hexadecimal notation 


CC = Checksum. Eight bit sum modula 256, of the four 
bit hexadecimal values of the digits that make up the 
data bytes. 

Carriage Return 

(Beginning of next record) 


OUTPUT 

NOTES 

1) Number of bytes per record is variable. See Table 3.1. 

2) Each line ends with nonprinting line feed, carriage return 
and nulls 

2 Hex characters 1 byte —Data Record 


/AAAABCCC ^ 

End of File Record 



// =Two Start Characters 

XX.. X = Arbitrary string of ASCII characters 

Carriage Return 


END OF FILE RECORD 



START CHARACTER 


AAAA Transfer Address 


Byte Count. BC = 00 in End of File Record 

CC = Checksum. Eight bit sum of the four bit 
hexadecimal values of the six digits that make up 
the transfer address and the byte count 
(hexadecimal notation) 

Carriage return 


LEGEND 


= Start Characters 
AAAA = Address Field 

BC = Byte Count (Date Bytes/Record) 

CC = Checksum of Record 

HH = Two Hexadecimal Digits (0-9, A-F) 

X = Any ASCII Character 
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Extended Tekhex Format 

Copyright 1983, Tektronix; reprinted by permission 
Extended Tekhex uses three types of message blocks: 

1. The data block contains the object code. 

2. The symbol block that contains information about a 
program section and the symbols associated with it. This 
information is only needed for symbolic debug. 

3. The termination block contains the transfer address and 
marks the end of the load module. 

NOTE 

Extended Tekhex has no specially defined abort block. 

To abort a formatted transfer, use a Standard Tekhex 
abort block. 

Each block begins with a six-character header field and ends with an end- 
of-line character sequence (on the 8550, a carriage return). A block can be 
up to 255 characters long, not counting the end-of-line character. The 
header field has the format shown in the following table. 
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ITEM 

% 

NUMBER 

OF ASCII 

CHARACTERS 

1 

DESCRIPTION 

A permit sign specified that the block is 
in Extended Tekhex format. 

Block 

Length 

2 

The number of characters in the block: a 
two-digit hex number. This count does not 
include the leading % or the end-of-line. 

Block 

Type 

1 

6 = data block 

3 = symbol block 

8 = termination block 

Checksum 

2 

A two-digit hex number representing the 
sum, mod 256, of the values of all the 
characters in the block, except the leading 
%, the checksum digits, and the end-of-line. 
The following table gives the values for 
all characters that may appear in Extended 
Tekhex message blocks. 


Character Values for Checksum Computation 

CHARACTERS 

VALUES (DECIMAL) 

0. .9 

0. .9 

A..Z 

10..35 

$ 

36 

% 

37 

. (period) 

38 

_ (underscore) 

39 

a. .z 

40-65 
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VARIABLE-LENGTH FIELDS 

In Extended Tekhex, certain fields may vary in length from 2 to 17 
characters. This practice enables you to compress your data by eliminating 
leading zeros from numbers and trailing spaces from symbols. The first 
character of a variable-length field is a hexadecimal digit that indicates the 
length of the rest of the field. The digit 0 indicates a length of 16 
characters. 

For example, the symbols START, LOOP, and KLUDGESTARTSHERE 
are represented as 5START, 4LOOP, and OKLUDGESTARTSHERE. The 
values 0,100H, and FF0000H are represented as 10, 3100, and 6FF0000. 

DATA AND TERMINATION BLOCKS 

If you do not intend to transfer program symbols with your object code, 
you do not need symbol blocks. Your load module can consist of one or 
more data blocks followed by a termination block. The following table 
gives the format of a data block and a termination block. 


Extended 

Tekhex 

Data Block 

Format 

ITEM 

Header 

NUMBER 

OF ASCII 

CHARACTERS 

6 

DESCRIPTION 

Standard header field 

Block Type = 6 

Load Address 

2 to 17 

The address where the object code is to be 
loaded: a variable-length number. 

Object 


2n 

n bytes, each represented as two hex 
digits. 

Extended 

Tekhex 

Termination 

Block 

Header 


6 

Standard header field 

Block type = 8. 
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SYMBOL BLOCKS 

A symbol used in symbolic debug has the following attributes: 

1. The symbol itself: 1 to 16 letters, digits, dollar signs, 
periods, a percent sign, or symbolize a section name. 

Lower case letters are converted to upper case when they 
are placed in the symbol table. 

2. A value: up to 64 bits (16 hexadecimal digits). 

3. A type: address or scalar. (A scalar is any number that is 
not an address.) An address may be further classified as a 
code address (the address of an instruction) or a data 
address (the address of a data item). As symbolic debug 
does not currently use the code/data distinction, the 
address/scalar distinction is sufficient for standard 
applications of Extended Tekhex. 

4. A global/local designation. This designation is of limited 
use in a load module, and is provided for future 
development. If the global/local distinction is not 
important for your purposes, simply call all your symbols 
global. 

5. Section membership. A section may be thought of as a 
named area of memory. Each address in your program 
belongs to exactly one section. A scalar belongs to no 
section. 

The symbols in your program are conveyed in symbol blocks. Each symbol 
block contains the name of a section and a list of the symbols that belong to 
that section. (You may include scalars with any section you like.) More 
than one block may contain symbols for the same section. For each 
section, exactly one symbol block should contain a section definition field, 
which defines the starting address and length of the section. 

If you object code has been generated by an assembler or compiler that 
does not deal with sections, simply define one section called, for example, 
MEMORY, with a starting address of 0 and a length greater than the 
highest address used by your program; and put all your symbols in that 
section. 
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The following table gives the format of a symbol block. Tables that follow 
give the formats for section definition fields and symbol definition fields, 
which are parts of a symbol block. 

Extended Tekhex 

Block Format 


ITEM 

Header 

NUMBER 

OF ASCII 

CHARACTERS 

6 

DESCRIPTION 

Standard header field 

Block Type = 3 

Section Name 

2 to 17 

The name of the section that contains the 
symbols defined in this block: a 
variable-length symbol. 

Section 

Definition 

5 to 35 

This field must be present in exactly one 
symbol block for each section. This field 
may be preceded or followed by any number 
of symbol definition fields. The table on 
the next page gives the format for this 
field. 

Symbol 

5 to 35 

Zero or more symbol definition fields as 
described in the next table. 


Extended Tekhex Symbol Block: 

NUMBER 

OF ASCII 

Section Definition Field 

ITEM 

CHARACTERS 

DESCRIPTION 

0 

1 

A zero signals a section definition field. 

Base 

2 to 17 

The starting address of the Address 
section: a variable-length number. 

Length 

2 to 17 

The length of the section: a variable-length 
number, computed as 1 + (high address base 
address). 
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Extended Tekhex Symbol Block: 

Symbol Definition Field 


NUMBER 

OF ASCII 


ITEM 

CHARACTERS 

DESCRIPTION 

Type 

1 

A hex digit that indicates the global/local 
designation of the symbol, and the type of 
value the symbol represents: 

1 = global address 

2 = global scalar 

3 = global code address 

4 = global data address 

5 = local address 

6 = local scalar 

7 = local code address 

8 = local data address 

Symbol 

2 to 17 

A variable-length symbol. 

Value 

2 to 17 

The value associated with the symbol: a 
variable-length number. 


NOTE: Symbol records are currently ignored by the Emulator. 

The following figures show how the preceding tables of information might 
be encoded in Extended Tekhex. The information for the Tekhex Symbol 
Block illustration could be encoded in a single 96-character block. It is 
divided into two blocks for purposes of illustration. 
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Figure 19. Tekhex Data Block 



Figure 20. Tekhex Termination Block 
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Figure 21. Tekhex Symbol Block 


t t 


■ Block length: 37H = 55 

■ Checksum: 60H = (3+7+3+8+28+31+12+28+29+...)mod 256 


r 


Section definition field: 

base address = 40H; length = C6H 


%373608SVCSTUFF0240C622CRID140PEN25014READ25815WRITE260 

%373C88SVCSTUFF15CLOSE26814EXIT27029BUFLENGTH28013BUF278 


t_ 


Section name: 
Block type: 3 
Header character 
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Motorola S-Record Format 

S-RECORD CONTENT 

When viewed by the user, S-records are essentially character strings made 
of several fields which identify the record type, record length, memory 
address, code/data, and checksum. Each type of binary data is encoded as 
a 2-character hexadecimal number: the first character representing the 
high-order 4 bits, and the second the low-order 4 bits of the byte. 

The 5 fields which comprise an S-record are: type, length, address, 
code/data and checksum. 

The fields are composed as follows: 



PRINTABLE 


FIELD 

CHARACTERS 

CONTENTS 

type 

2 

s-record type -- SO, SI, etc. 

record length 

2 

The count of the character pairs in the 
record, excluding the type and record length. 

address 

4, 6, or 8 

The 2-, 3-, or 4-byte address at or which the 
data field is to be loaded into memory. 

code/data 

0-2n 

From 0 to n bytes of executable code, memory- 
loadable data, or descriptive information. 

For compatibility with teletypewriters, some 
programs may limit the number of bytes to as 
few as 28 (56 printable characters in S- 
record). 

checksum 

2 

The least significant byte of the one's 
complement of the sum of the values 
represented by the pairs of characters making 
up the record length, address, and the 
code/data fields. 


Each record may be terminated with a CR/LF/NULL. Additionally, an S- 
record may have an initial field to accommodate other data such as line 
numbers generated by some time-sharing systems. 
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Accuracy of transmission is ensured by the record length (byte count) and 
checksum fields. 

S-RECORD TYPES 

Eight types of S-records have been defined to accommodate the several 
needs of the encoding, transportation, and decoding functions. The 
various Motorola upload, download, and other file-creating or debugging 
programs, utilize only those S-records which serve the purpose of the 
program. For specific information on which S-records are supported by a 
particular program, the user’s manual for that program must be consulted. 

An S-record format module may contain S-records of the following types: 

50 The header record for each block of S-records. The 
code/data field may contain any descriptive 
information identifying the following block of S0- 
records. Under VERSAdos, the resident linker’s 
IDENT command can be used to designate module 
name, version number, revision number, and 
description information which will make up the header 
record. The address field is normally zeros. 

51 A record containing code/data and the 2-byte address 
at which the code/data is to reside. 

52 A record containing code/data and the 3-byte address 
at which the code/data is to reside. 

53 A record containing code/data and the 4-byte address 
at which the code/data is to reside. 

S5 A record containing the number of SI, S2, and S3 

records transmitted in a particular block. This count 
appears in the address field. There is no code/data 
field. 

S7 A termination record for a block of S3 records. The 

address field may optionally contain the 3-byte address 
of the instruction to which control is to be passed. 
There is no code/data field. 
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58 A termination record for a block of S2 records. The 
address field may optionally contain the 3-byte address 
of the instruction to which control is to be passed. 
There is no code/data field. 

59 A termination record for a block of SI records. The 
address field may optionally contain the 2-byte address 
of the instruction to which control is to be passed. 
Under VERSAdos, the resident linker’s ENTRY 
command can be used to specify this address. If not 
specified, the first entry point specification 
encountered in the object module input will be used. 
There is no code/data field. 

Only one termination record is used for each block of S-records. S7 and S8 
records are usually used only when control is to be passed to a 3- or 4- byte 
address. Normally, only one header record is used, although it is possible 
for multiple header records to occur. 

CREATION OF S-RECORDS 

S-record-format programs may be produced by several dump utilities, 
debuggers, VERSAdos’ resident linkage editor, or several cross assemblers 
or cross linkers. ON EXORmacs, the Build Load Module (MBLM) utility 
allows an executable load module to be built from S-records; and has a 
counterpart utility in BUILDS, which allows an S-record file to be created 
from a load module. 

Several programs are available for downloading a file in S-record format 
from a host system to an 8-bit microprocessor-based or 16-bit 
microprocessor-based system. Programs are also available for uploading 
an S-record file to or from an EXORmacs system. 

Example: Shown below is a typical S-record-format module, as printed or 
displayed: 
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S0060000484421B 

SI130000285F245F2212226A00042429000082337CA 
SI13001000020000800082629001853812341001813 
S113002041E9000084E42234300182342000824A952 
SI 07003000144Ed492 
S9030000FC 


The module consist of one SO record, four SI records, and an S9 record. 
The SO record is comprised of the following character pairs: 


SO S-record type SO, indicating that it is a header record. 

06 Hexadecimal 06 (decimal 6), indicating that six character pairs (OR 
ASCII bytes) follow. 

00 + 

00 Four-character 2-byte address field, zeros in this example. 

48 

44+ ASCII H, D, and R - "HDR". 

52 

IB The checksum. 


The first SI record is explained as follows: 


SI S-record type SI, indicating that it is a code/data record to be 

loaded/verified at a 2-byte address. 

13 Hexadecimal 13 (decimal 19), indicating that 19 character pairs, 
representing 19 bytes of binary data, follow. 

00+ Four-character 2-byte address field; hexadecimal address 

00 0000, where the data which follows is to be loaded. 


The next 16 character pairs of the first SI record are the ASCII bytes of the 
actual program code/data. In this assembly language example, the 
hexadecimal opcodes of the programs are written in sequence in the 
code/data fields of the SI records: 
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OPCODE 

INSTRUCTION 

285 F 

MOVE.L 

(A7) +,A4 

245 F 

MOVE.L 

(A7) +,A2 

2212 

MOVE.L 

(A2),D1 

226A0004 

MOVE.L 

4(A2),A1 

24290008 

MOVE.L 

FUNCTI0N(A1),D2 

237C 

MOVE.L 

#F0RCE FUNC,FUNCTION(Al) 


o (The balance of this code is continued in the code/data 

fields of the remaining SI records, and stored in memory 
location 0010, etc.) 

2A The checksum of the first SI record. 


The second and third SI records each also contain $13 (19) character pairs 
and are ended with checksums 13 and 52 respectively. The fourth SI 
record contains 07 character pairs and has a checksum of 92. 

The S9 record is explained as follows: 


S9 S-record type S9, indicating that it is a termination record. 

03 Hexadecimal 03, indicating that three character pairs (3 bytes) follow. 
00 The address field, zeros. 

FC The checksum of the S9 record. 


Each printable character in an S-record is encoded in hexadecimal (ASCII 
in this example) representation of the binary bits which are actually 
transmitted. 
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- A - 

Absolute address, 5-90 
Absolute value, 4-17 
Acknowledge character, 5-3 
Address comparators, 7-3, 8-3 
Addressing 
68020,5-57 
Address registers, 5-89 
Alpha/numeric value, 4-8 
AND, 4-16,7-9,8-5 
ASM, 6-34 
Assembler, 6-32 
Assembler directives, 6-36 


- B - 

Backspace, 4-31 
Base, 5-85 

Base definition symbols, 4-11 

Base register, 4-10 

Bases 

Default, 5-85 
Input values, 5-85 
BAS 5-79 

Baud rate, 3-12, 5-3, 5-29 
Block data 
Verify, 6-22 
Block move, 6-24 
Verify, 6-27 
BMO, 6-24 


BNC connector, 3-6, 7-24, 8-59 
Breaking emulation, 7-15, 8-11 
Breakpoint, 8-11 
Breakpoints, 6-2, 7-15 
BTE, 5-12 
Bus cycles, 5-94 
Bus error registers 
68020,5-74 
BUS, 6-81 
Bus speed, 5-23 
Bus time out enable, 5-12 
Byte mode, 4-28, 6-15 


- C- 

Cables, 3-8, 3-16 

Cache disable, 5-14 

CAS, 5-13 

CCR register, 5-77 

CCT, 5-30 

CCT, 5-32, 5-35 

CDS, 5-14 

CES, 7-14, 8-10 

Changing event groups, 8-62 

Checksums, 5-38 

Clear memory map, 5-62 

Clear trace memory, 5-102 

Clear WHEN/THEN 

statements, 7-14, 8-10 
CLK, 6-79 
CLM, 5-62 
Clock,6-79 
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CLT, 5-102 
CMC, 5-121 
Code space, 5-63 
Colon operator, 5-126 
Command entry mode, 6-3 
Commands 

Abbreviating, 7-1, 8-1 
Command line, 4-6 
Commonly used, 4-21,4-22, 
4-23,4-24 

Delay execution, 6-11 
ESL, 4-6 
Exceptions, 4-6 
Memory, 6-15 
Mnemonics, 4-8 
Port dependent, 5-30 
Repeating, 5-91, 5-122, 5-125 
Save keystrokes, 5-87, 5-89 
Set-up, 5-1 
Single character, 4-7 
Terminator sequence, 5-3 
Communication with host, 5-30 
Communication with target 
programs, 5-47 
Comparator registers, 7-2, 8-2 
Computer port control, 5-39 
COM, 5-47 
Configuration 
Menus, 5-1 
System, 1-4 

Continuous address strobe, 5-13 

Control Boards, 3-3 

Control characters, 4-31 

Copy data, 5-15 

Copy system variables, 5-27 

Count bus cycles, 7-20, 8-55 

Counter/timer use, 3-6, 7-24, 8-59 

Counting events, 7-20, 8-55 

Count limit, 7-8, 8-4 

Count limit comparator, 7-8, 8-4 

CPY, 5-15 

CRC, 6-80 

CRE, 6-80 

CRO, 6-80 

CRT length, 5-3 

Ctrl Q, 4-31 

Ctrl R, 4-31 

Ctrl S, 4-31 


Ctrl X, 4-31 
Ctrl Z, 4-31 

Custom diagnostics, 6-49, 6-75 
Customer service, 2-6 
Cycle (68010), 6-13 
Cyclic redundancy check, 6-68, 
6-80 
CYC, 6-13 


- D- 

Data, 7-4, 8-3 
Download, 5-37 
Upload, 5-43 
Data buffering, 5-29 
Data comparators, 7-4, 8-3 
Data registers, 5-87 
Data requirements, 3-14 
Data space, 5-63 
Data Strobe messages, B-4 
DB-25 connectors, 5-29 
DBP, 5-16 
DB, 6-17 

Default base, 5-85 
Default base register, 4-10 
Defining action lists, 7-10, 8-6 
Defining events, 7-9, 8-5 
Delay command execution, 6-11 
Delete, 4-31 
DEL, 5-132 
DES, 7-12, 8-8 
DFB, 5-85 

Diagnostic functions, 6-49 
Diagnostics 

Complete RAM test, 
looping, 6-56 

Complete RAM test, single 
pass, 6-53 

CRC check of emulator, 6-68 
Custom, 6-49, 6-69 
Generate reset pulses, 6-67 
Pass parameters, 6-76 
Pass parameters to, 6-78 
Read continuously from 
address, 6-58 
Read data over entire 
range, 6-65 

Simple RAM test, looping, 6-54 
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Index 


Simple RAM test, single 
test, 6-51 

Write alternate patterns, 6-60 
Write continuously to 
address, 6-59 

Write incrementing count, 6-66 
Write pattern then read, 6-64 
Write pattern then rotate, 6-62 
DIA,5-51 

Disable bus errors on 

peeks/pokes, 5-16 
Disassembler, 6-39 
Disassemble trace memory, 5-103 
Disassemble trace page, 5-116 
Display 
Base, 5-85 
Blank line, 5-136 
Bus status, 6-81 
Character string, 5-51 
Event specifications, 7-12, 8-8 
Macros, 5-118 
Memory block, 6-17 
Raw trace bus cycles, 5-94 
Revision dates, 5-135 
Symbols, 5-128 
DIS,6-39 
DM, 5-54 
DNL, 5-37 

Don’t care values, 4-11, 5-68, 7-4, 
8-3 
Download 

Corruption, 5-42 
Custom diagnostics, 6-75 
Errors, 5-40 

From computer port, 5-31 
From terminal port, 5-31 
Port control differences, 5-39 
Procedures, 5-37 
Record format, 5-7 
Symbols, 5-39 
DR, 5-76 
DRT, 5-23, 5-94 
DST, 5-108 
DTB, 5-116 
DTF, 5-116 
DT, 5-103 

Dyadic operator, 4-19 


- E- 

ECS, 5-17 

EEPROM, 5-1,5-10, 5-25 
EEPROM Groups, 5-1 
EMS control statements, 7-9, 8-5 
Emulation, 5-93, 6-2 
Breaking, 7-15,8-11 
Halting, 6-3, 6-4 
Resetting, 6-3 
Run mode, 6-2 
Starting, 6-2 
Emulator set-up, 2-1 
END, 6-34 
Equation, 4-8 
Error messages, 4-32, B-l 
Data Strobe, B-4 
Errors 

ESL,4-32 
message, B-l 
Escape sequence, 5-3 
Esc esc,4-31 
ES Language, 4-1 
ES Language syntax, 4-2 
Event, 7-9, 7-27, 8-5 
Event groups, 7-1, 8-1 
Changing, 7-27, 8-62 
Event Monitor System, 4-15, 4-22, 
4-24,7-1,8-1 
Action definition, 8-6 
Address comparators, 7-3, 8-3 
Change event groups, 8-62 
Clear WHEN/THEN, 8-10 
Comparator registers, 7-2, 8-2 
Count Events, 7-20 
Count events:, 8-55 
Data and LSA comparators, 7-4, 
8-3 

Define action list, 7-10, 8-6 
Display WHEN/THEN 
statements, 7-12, 8-8 
Event definition, 7-9, 8-5 
Event specs, 8-8 
Mode selection, 8-15 
S-71 

Setup shortcuts (68020), 8-64 
Special interrupts, 7-25, 8-60 
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Status comparators, 7-4, 8-4 
Status mnemonics, 7-5, 8-4 
Trace events, 7-17, 8-12 
Trace mode 0 (68020), 8-19 
Trace mode 1 (68020), 8-27 
Trace mode 2 (68020), 8-36 
Trace mode 3 (68020), 8-45 
Trigger signal, 7-24, 8-59 
Event monitor system 

Clear WHEN/THEN, 7-14 
Event Monitor System actions, 8-6 
Execute bus cycle, 6-13 
Executing custom diagnostics, 6-69 
Expression, 4-8 
Extend command lines, 4-6 
Extended Tekhex serial data 
records, 5-126 
External cycle start, 5-17 


- F- 

Fast time out, 5-20 
Files 

Closing, 5-43, 5-46 
format, 3-12 
Opening, 5-45 
Viewing, 5-43 
Fill operator, 6-21 
FIL,6-21 

Find memory pattern, 6-19 
FIN,6-19 
FTO, 5-20 
Fuse, 3-7 


-G- 

GD, 5-87 

General Emulator registers, 5-70 
General purpose address 
registers, 5-89 
General purpose data 
registers, 5-87 
Generate reset pulses, 6-67 
Groups, 4-15, 7-9, 7-27,8-5,8-62 
GR, 5-89 


- H- 

Halting emulation, 6-3 
Hard copy, 5-11,5-15 
Help, 4-20 

Communications set-up, 4-20 
Software switches, 4-20 
Special diagnostic 
functions, 4-20 
Help menu 

(68000/08/10), 4-21 
(68020), 4-23 

Hex format data files, 3-12 
Host computer, 5-29, 5-30 


- I- 

IDX, 5-122 
ILG, 5-56 

Illegal statement, 4-1 
IM, 5-21 
Indirection, 4-9 
Indirection operator, 4-13 
Initializing Emulator, 5-26 
Integer, 4-8 
Interrupt enable, 5-18 
Introspective mode, 5-21 


- J- 

Jump to specified address, 8-60 


- L- 

LD, 5-27 
LDV, 6-9 
LIM, 5-122 

Line assemble parameters, 6-34 
Line assembler, 4-29, 6-32, 6-34 
Line assembler prompt, 4-27 
Load 

Overlay memory, 5-65 
Overylay memory, 6-29 
Reset vectors, 6-9 
Variables from EEPROM, 5-25 
Logic state analyzer (LSA), 1-10, 
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3-11 

Logic state probe, 7-4, 8-3 
LOV, 5-65, 6-29 
LSA comparators, 7-4, 8-3 
LST, 6-46 


- M- 

MAC, 5-118 

Macros, 5-87, 5-89, 5-117 
Clearing, 5-121 
Define, execute, 5-119 
Displaying, 5-118 
Saving, 5-117 
Truncation, 5-117 
Maintenance, 3-16 
Mapping the 68020, 5-57 
MAP, 5-55 
Memory 

Assembler, 6-32 
Clear memory map, 5-62 
Disassembler, 6-39 
Display memory map, 5-54 
Fill with data, 6-21 
Find data pattern, 6-19 
Loading from target to 
overlay, 5-65 
Mapping, 5-55 
Modifying, 6-41 
Scrolling direction, 6-41 
Trace, 5-92 
Verify overlay, 5-66 
Viewing, 6-41 
Memory block display, 6-17 
Memory commands, 6-15 
Memory disassembler, 4-29, 6-39 
Memory mode, 4-29 
Entering, 6-42 
Exiting, 6-45 
Modifying data, 6-43 
Scroll direction, 6-41 
Scrolling, 6-46 

Memory mode pointer, 5-83, 6-47 
Memory mode prompt, 4-27 
Memory mode status register, 5-81 
MMP, 5-83, 6-47 
MMS, 5-81 
Mode 


operation, 8-20 
Setup, 8-20 
Mode 0, 8-64 
Mode 1, 8-64 
Mode 2, 8-65 
Mode 3, 8-66 
Modes 

Memory, 6-41 
Special ESL, 4-28 
Mode selection, 8-15 
M, 6-42 


- N- 

NOT, 4-15, 7-9, 8-5 
Null target, 3-10 
Numbers 
ESL,4-10 
NXT, 6-46 


- O- 

OFF, 5-9 

ON/OFF menu, 5-1, 5-9 
ON, 5-9 

Operand cycle start, 5-17 
Operation 

mode 0, 8-20 
Operator 

Repeat, 5-122 

Operator precedence, 4-9, 4-17 
Operators 
ESL,4-9 

OR, 4-16, 7-9, 8-5 
Oscilloscope use, 3-6,6-49, 7-24, 
8-59 

Overlay map, 5-56 
Overlay memory, 1-9, 5-37, 5-53 
Load,6-29 
Verify, 6-30 

Overlay memory enable, 5-63 
Overlay memory speed, 5-67 
OVE, 5-63 
OVS, 5-67 
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- P- 

Page through memory, 6-17 
Parentheses, 7-9, 8-5 
ESL,4-8 
indirection, 4-13 
WHEN/THEN, 4-15 
Parity, 5-3 
Parts, 3-17 

Passing parameters to custom 
diagnostics, 6-71, 6-76 
Patching code, 7-25, 8-60 
Pause, 8-11 

Pause mode, 1-7, 7-15, 8-11 
Peeking and Poking into target 
system, 6-71 

Peeking and Poking into target 

system (68000/68008), 6-73 
Peek Poke trace, 5-22 
Peeks, 6-58 

Performance Analysis, 5-92 
Peripheral equipment, 3-6 
Pin configurations, 3-12 
Pod assembly, 3-8 
Pokes, 6-59 
Port Control 

Establish controlling port, 5-30 
Port control, 3-12, 5-15, 5-29 
Computer, 5-35 
Terminal, 5-34 
Transparent mode, 5-32 
Port dependent commands, 5-30 
Ports 

Configuration, 5-29 
Control considerations, 5-37 
Controlling port, 5-35 
Copying data to, 5-15 
Power, 3-20 
Power-on sequence, 2-5 
Power supply, 3-1 
PPT, 5-22 

Printing session, 5-11,5-15 
Probe tip assembly, 3-16 
Prompts, 4-27 
ESL, 4-27 
PUR, 5-133 


- R- 

RAM 

Testing, 6-49 
RAM test 

Complete, 6-53 
Simple, 6-51 
RAM test, looping 
Complete, 6-56 
Simple, 6-54 
Range,4-11 
ESL,4-11 

Raw trace bus cycles, 5-94 

RBK, 6-5 

RBV, 6-5 

Readability, 5-136 

Read data over range, 6-65 

Read target system clock, 6-79 

Real time, 1-8 

Rear Panel, 3-6 

Register list, 5-68 

Registers, 5-68 

Address, 5-89, 7-3, 8-3 
Bus error, 5-72 
Clearing, 5-76 
Comparator, 1-2—1-6, 8-2 
Count, 7-20, 8-55 
Data, 5-81, 5-87 
Display base, 5-71, 5-79 
Displaying, 5-76 
Event Monitor System, 5-71 
General Emulator, 5-70 
General Purpose, 5-117 
General purpose address, 5-89 
General purpose data, 5-87 
Loading, 5-77 
Memory mode pointer 
MMP, 6-41, 6-42 
Modifying, 5-77 
Overlay memory, 5-53 
Reset status, 6-14 
Saving, 5-71 
Set/display base, 5-79 
68000/68008 target, 5-69 
68010 target, 5-69 
68020 target, 5-70 
Types, 4-13 
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Using in run mode, 6-4 
Repeat command line, 4-6, 4-30, 
5-125 

Repeat operators, 5-122 
Reset, 6-14 

Generate reset pulses, 6-67 
Reset char, 5-3 
Reset vectors, 6-2 
RET, 5-136 
Revision dates, 5-135 
REV, 5-135 
RNV, 6-5 
RO, 5-56 
*,5-122 
/,5-125 
RST, 6-14 

Run mode, 6-1, 6-2, 7-1, 8-1 
Register use, 6-4 
Run mode commands, 6-16 
Run mode prompt, 4-27 
RUN, 6-5 

Run target program, 6-5 
RW, 5-55 


- S- 

Saved 

ON/OFF menu, 5-1 
Parameters, 5-8 
Registers, 5-71 
SET menu, 5-1 
Switches, 5-11 
Saved variables, 5-25 
SAV, 5-25 
Scope loops, 6-49 
Searching 

Trace memory, 5-92 
SEC, 5-129 
Sections, 5-126 

Deleting, 5-132, 5-133 
Display, 5-129 
Sequence numbers, 5-94 
Serial communications, 5-29 
Serial data formats, C-l 
Serial ports, 3-6, 3-12 
Serial port set-up, 5-3 
Service, 0-4, 2-6, 2-10 
Set memory map, 5-55 


SET menu, 5-1, 5-3 
SET, 5-3 
Setup, 8-64 
Mode, 8-64 
Mode 0, 8-20 
Mode 1, 8-64 
Mode 2, 8-65 
Mode 3, 8-66 
System, 1-4 
Set-up 

Commands, 5-1 
Emulator, 2-1 
Target system, 2-4 
SF 0,6-51 
SF 10, 6-58 
SF 11,6-59 
SF 12,6-60 
SF 13,6-62 
SF 14,6-64 
SF 15,6-65 
SF 16,6-66 
SF 17,6-67 
SF 1,6-53 
SF 20,6-68 
SF3, 6-56 
Shortcuts 
68020,8-64 
EMS setup, 8-64 
Signing 
ESL, 4-16 

Simulation tool, 3-10 
Single-Argument Operators, 4-18 
Single step, 5-122, 5-125 
SLO, 5-18 

Special characters, 4-31 
Special functions, 4-29, 6-50 
Special interrupts, 7-25, 8-60 
Special modes, 4-28 
S-records 

creation, C-l6 
types, C -15 
SR register, 5-77 
STA, 5-114 
Status, 7-4, 8-4 
Status comparators, 7-4, 8-4 
Status mnemonics, 7-5, 8-4 
STD, 5-114 

Stop and step target system, 6-8 
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Stop bits, 5-3 
Stopping emulation, 6-4 
STS, 5-114 
Switches, 5-9 

Bus time out enable, 5-12 
Cache disable, 5-14 
Continuous strobe, 5-13 
Copy data to both ports, 5-15 
Disable bus errors on 
peeks/pokes, 5-16 
External cycle start, 5-17 
Fast time out, 5-20 
Interrupt enable, 5-18 
Introspective mode, 5-21 
Peek poke trace, 5-22 
Tri-state address, 5-24 
View bus speed info, 5-23 
Switch setting menu, 5-9 
Symbolic references, 1-10,4-10 
Symbol names, 5-90 
Symbols, 5-126 
Define, 5-130 
Deleting, 5-132, 5-133 
Display, 5-128 
Downloading, 5-39 
Uploading, 5-45 
Symbol tables, 5-126 
SYM, 5-128 

System configuration, 1-4 
System operation, 1-7 
System setup, 1 -4 


- T- 

TAD, 5-24 
Target, 6-1 

Communication with, 5-47 
Cyclic redundancy check, 6-80 
Definition, 6-1 
Display characters from 
memory, 5-51 
Execute in bus cycles, 6-13 
Loading into Emulator, 6-29 
Read clock, 6-79 
Run program,-6-5 
Stop and step system, 6-8 
Target commands, 6-1 
Target memory, 5-37 


Target system peeks, 6-58 
Target system pokes, 6-59 
Target system set-up, 2-4 
TCT, 5-30 
TCT, 5-32, 5-34 
Temperature, 3-20 
Terminal port control, 5-38 
Test run of system, 2-6 
TGT, 5-56 

Thumbwheel switch, 2-2, 3-3, 3-^ 
Timestamping, 5-92 
TIM, 5-107 
Trace 

Clear trace memory, 5-102 
Disassemble memory, 5-103 
Disassemble page, 5-116 
Display bus cycles, 5-94 
Trace and Break, 8-14 
Trace a subroutine, 7-27, 8-62 
Trace bus cycles, 7-17, 8-12 
Trace memory, 1-8, 5-92 
Searching, 5-92 
Trace memory modes 
selection, 5-93 
Trace mode 0 (68020), 8-19 
Trace mode 1,8-15 
Trace mode 1 (68020), 8-27 
Trace mode 2, 8-15 
Trace mode 2 (68020), 8-36 
Trace mode 3, 8-15, 8-45 
Trace mode 3 (68020), 8-45 
Trace mode selection, 8-15 
Tracing events, 7-17, 8-12 
Transparent mode, 4-29, 5- 
5-32 

Entering, 5-30 
Exiting, 5-30 
TRA, 5-32 

Trigger signal, 7-24, 8-5 
Tri-state address, 5-24 
Troubleshooting, 3-18 
TST, 5-91 


1-8 




Index 


- U- 

Unary operator, 4-16 
Upload 

Record format, 5-7 
Serial data, 5-43 
Symbols, 5-45 
UPL, 5-43 
UPS, 5-45 
UserO, 5-3 
Userl, 5-3 


- V - 

VBL, 6-22 

VBM, 6-27 
Vectors 

Load reset, 6-9 
Verify block data, 6-22 
Verify overlay memory, 5-66, 6-30 
Verify serial data, 5-42 
VFO, 5-66, 6-30 
VFY, 5-42 

View bus speed information, 5-23 


- W- 
WAI, 6-11 

WHEN/THEN, 1-9, 7-1, 8-1 
Word mode, 4-28, 6-15 
Write data, 6-64 
Write incrementing count, 6-66 
Write pattern, 6-62 
Write patterns, 6-60 


- X- 


X,6-34 

XON/XOFF, 3-14, 5-3, 5-29, 
5-44,6-18 
X, 6-45 
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